https://github.com/konapun/jquery.ctrl-forward.js

Semantic form action forwarding based on form inputs
https://github.com/konapun/jquery.ctrl-forward.js

Last synced: 22 days ago
JSON representation

Semantic form action forwarding based on form inputs

• Host: GitHub
• URL: https://github.com/konapun/jquery.ctrl-forward.js
• Owner: konapun
• Created: 2013-11-04T22:27:44.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2014-02-17T18:00:26.000Z (over 10 years ago)
• Last Synced: 2024-04-14T19:58:14.867Z (7 months ago)
• Language: JavaScript
• Size: 160 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# jquery.ctrl-forward.js

Easy semantic form action changes for jQuery

## Motivation

I wanted a nice way to interact with wildcard controllers in order to provide prettier URLs than those

with GET params littering the string. To achieve this, I needed to be able to change form actions on the

fly based on some other tags within the form. Enter the jQuery forward controller.

## Usage

```html

	

	

	

	

```

```js

$('.ctrl-forward').ctrlForward({

	'fwd-attr': 'data-forward', // This is the default attribute

	'method': 'link' // "get", "post", "link", or undefined [default]. When undefined, the action defined in the form is taken.

});

```

Now, when the form's `submit` button is clicked, the form's action will automatically be set to

`/search/dual/first/second`, or whatever the value of `textbox1` and `textbox2` are at the time the

submit button is clicked.

A form is not required when using method "link". You can choose the method to use by setting `data-method`

to `get`, `post`, or `link` in the tag that specifies the `data-forward` attribute.

### Advanced usage

Any text within the [ and ] tags in the data-forward attribute are executed within the context of jQuery.

To further scope this selection, the modifiers `^` and `>` are available which stand for the jQuery methods

`parents` and `siblings`, respectively which must be the first character within the [] tags.

## Options

**fwd-attr**: Specify the attribute the action will be defined in (default: `data-forward`)

  

**method**: [`get`|`post`|`link`|`undefined`] Specify the method used to submit the form. If undefined (default),

the method defined in the form will be used. If the type is `link`, the action will be submitted as a link and

the form's action will be cancelled.

**override**: Allow `method` setting in ctrlForward invocation to override any methods set using the attribute

`data-method` (default: `false`)