form-parse
Takes a form element and transforms the input values into an object.
NOTE: this is the successor to form-serialize, but it drops component/duo in favor of mako. (uses npm for deps, like browserify)
Usage
var parse = ;var form = document; ;// => { id: '123456', username: 'dominicbarnes' }
API
parse(form, [transformer])
Takes the given form
element and collects the values of all of the
submittable
elements into a single JS object
Fields can be namespaced by using square bracket notation. For example:
id: "1" user: name: "dominic" website: "http://dbarnes.info/" tags: "a" "c"
See squares for documentation about how square-bracket notation is implemented here.
The transformer
parameter (a Function
) can be used to transform the field values during
serialization. (eg: parse numbers, dates, etc) This function receives 3 arguments: the name
of the field, the input's value
and the element
itself.
;
NOTE: if using transformer
, you should always return something, because the return
value will clobber whatever other value was retrieved.