hongymagic / jquery.serializeobject

Encode a set of form elements as a JSON object for manipulation/submission.

What is it?

$.serializeObject is a variant of existing $.serialize method which, instead of encoding form elements to string, converts form elements to a valid JSON object which can be used in your JavaScript application.

Why?

Whilst it isn't necessary in most cases, and by that I mean 99.99% kind of most, there are times when we manipulate form data on client side. Personally I find JSON much easier to work with than DOM or string manipulation.

How do I use it?

If you want to see the code and demo first: http://jsfiddle.net/davidhong/PRpJT/

Simply include the jQuery.serializeObject.js along with any jQuery instance and use it like $.serialize.

If you have a form like the following:

<form id="minutes">
	<input type="text" name="subject">
	<input type="text" name="minute-taker">
	<!-- ... -->
	<input type="checkbox" name="attendees" value="David" checked="checked">
	<input type="checkbox" name="attendees" value="Daniel" checked="checked">
	<input type="checkbox" name="attendees" value="Darwin" checked="checked">
</form>

and wish to convert them to a JSON object:

var minutes = $('form#minutes').serializeObject();

will return:

{
	"subject": "",
	"minute-taker": "",
	"attendees": [
		"David",
		"Daniel",
		"Darwin"
	]
}

Change log

2.0.3

• Add MIT License

2.0.2

• Add support for $.noConflict mode

2.0.0

Major version change: Camel casing of names have been removed. Please use version 1.0.4 if you require camel casing of names.

• Remove $.data like camelCasing on names

1.0.4

• Fix an issue (#2) where arrays longer than 2 resulted in incorrect values

Known issues

• In rare cases, this won't work with old checkbox/hidden hack. See this issue for more details.

jquery.serializeobject's Issues

Feature Request: Support nested objects

This is a feature request for supporting nested objects by doing the following:

<input name="name.first"><input name="name.last">

The above input would render to a JSON object that would look like {"name":{"first":"J","last":"Lo"}}.

The use case for this is supporting custom fields for applications that require customized forms. This allows nesting of any type of data without requiring a Javascript coder to do heavy manipulation either client-side or server-side. Would love to see this, and could possibly contribute myself if you explain what I need in order to set up my dev environment.

Publish npm package

I don't think its there, it would be much appreciated if it can be published.

Old trick doesn't work

Hello,

Be warned, the old trick where you have:

<input name="cgv" value="false" autocomplete="off" type="hidden">
<input name="cgv" value="true" autocomplete="off" type="checkbox">

doesn't work anymore, because it makes an array.

I find this solution:

formData = $form.serializeObject()
if ( typeof formData.cgv === 'undefined' ) formData.cgv = false

but maybe it could be good to have data-attr to handle that.

Re-sorted dynamic values, serializeObject keeps original structure?

Json one single value to multidimension array

Hello,

Is there any other way to convert from one single value to array? for example, I have below single object:
1st:
Object { js_language="1", js_language_level="1"}

and this is two values object:
2st:
Object { js_language=[2], js_language_level=[2]}

what I wanted is convert 1st from :
Object { js_language="1", js_language_level="1"}

to

Object { js_language=[1], js_language_level=[1]}

Are there any way to achieve it with serializeObject?

Thanks in advanced

AMD/requirejs support please

deserialize?

Anyone have nice tricks for deserializing an object back to a form (i.e. if you want to edit the object it later).

Upload it to the new jQuery Plugins site

There are some pre-requisites for this such as:

• Producing a package.json file as documented on plugins.jquery.com Github page; and
• Creating a post-receive hook to http://plugins.jquery.com/_update.

Array names

Inputs with array names like "foo[0]" are not converted to an array. Instead the literal string "foo[0]" is used as the property name.

No license

While this seems like a good library that does it's job, I cannot seem to find a license file for it. This makes it impossible to use the library in any public project.

Please consider adding a license to the project so that people can safely use your project (MIT or BSD preferred)