.asPairs(form, [options]) method

Like serialize, but returns an array of [fieldName, value] pairs.

Accepts

• form

  Form element

• options

  Options object, containing:

• options.elements

  Instead of returning an array of [fieldName, value] pairs, return an array of [fieldName, value, fieldElement] triples.

• options.emptyArray

  What to emit as the value of an empty select[multiple]. If you don't pass this option, nothing comes out.

• options.outputUnchecked

  falseWhether to emit unchecked checkboxes and unselected radio buttons.

.fillIn(form, map2) method

Sets form elements' values with values from an object

Note: You can't set the values of an input with type="file" (browser prohibits it)

Accepts

• form

  Form element to be populated

• map2

  Mapping of fields to values contained in fields. Can be a hash (keys as names, strings or arrays for values), or an array of [name, value] pairs.

Code

<form id="form">
    <input type="text" name="textfield">
    <input type="radio" name="radio" value="1">
    <input type="radio" name="radio" value="2">
    <input type="checkbox" name="check[]" value="1">
    <input type="checkbox" name="check[]" value="2">
    <button type="submit">Submit</button>
</form>
<script>
Ink.requireModules(['Ink.Dom.FormSerialize_1'], function(FormSerialize) {
    var form = Ink.i('form');
    var toFillForm = {
        textfield: 'foobar',
        radio: "2",
        "check[]": ["1"]
    };
    FormSerialize.fillIn(form, toFillForm);
});
</script>

.serialize(form, [options]) method

Serializes a form element into a JS object
It turns field names (not IDs!) into keys and field values into values.

note: Multi-select and checkboxes with multiple values will result in arrays

Accepts

• form

  Form element to extract data

• options

  Options object, containing:

• options.outputUnchecked

  falseWhether to emit unchecked checkboxes and unselected radio buttons.

Code

<form id="form">
    <input type="text" name="textfield" value="foo">
    <input type="radio" name="radio" value="1">
    <input type="radio" name="radio" value="2" checked>
    <input type="checkbox" name="check[]" value="1" checked>
    <input type="checkbox" name="check[]" value="2" checked>
    <button type="submit">Submit</button>
</form>
<script>
Ink.requireModules(['Ink.Dom.FormSerialize_1', 'Ink.Dom.Event_1'], function(FormSerialize, InkEvent) {
    var form = Ink.i('form');
    InkEvent.observe(form, 'submit', function(event){
        InkEvent.stopDefault(event);
        var oSerialize = FormSerialize.serialize(form);
        Ink.log(oSerialize); 
        // {
        //   textfield: "foo",
        //   radio: "2",
        //   check: ["1", "2"]
        // }
    });
});
</script>