jQuery.serializeArray() 函数详解

描述

 

• serializeArray()函数用于序列化一组表单元素，将表单内容编码为一个JavaScript数组。

• serializeArray()函数常用于将表单内容序列化为JSON对象，以便于被编码为JSON格式的字符串。

• 该函数会将可用于提交的每个表单控件封装成一个Object对象，该对象有name和value属性，对应该表单控件的name和value属性。然后将这些Object对象封装为一个数组并返回。

• 该函数不会序列化不需要提交的表单控件，这和常规的表单提交行为是一致的。例如：不在<form>标签内的表单控件不会被提交、没有name属性的表单控件不会被提交、带有disabled属性的表单控件不会被提交、没有被选中的表单控件不会被提交。

• 与常规表单提交不一样的是：常规表单一般会提交带有name的按钮控件，而serializeArray()函数不会序列化带有name的按钮控件。
• 该函数属于jQuery对象(实例)。

语法
 

• jQuery 1.2 新增该函数。
• jQueryObject.serializeArray( )
• 返回值：serializeArray()函数的返回值为Array类型，返回将表单元素编码后的JS数组。

示例&说明

请参考下面这段初始HTML代码：

 

 

1. <form name="myForm" action="http://www.365mini.com" method="post">

2. <input name="uid" type="hidden" value="1" />

3. <input name="username" type="text" value="张三" />

4. <input name="password" type="text" value="123456" />

5. <select name="grade" id="grade">

6. <option value="1">一年级</option>

7. <option value="2">二年级</option>

8. <option value="3" selected="selected">三年级</option>

9. <option value="4">四年级</option>

10. <option value="5">五年级</option>

11. <option value="6">六年级</option>

12. </select>

13. <input name="sex" type="radio" checked="checked" value="1" />男

14. <input name="sex" type="radio" value="0" />女

15. <input name="hobby" type="checkbox" checked="checked" value="1" />游泳

16. <input name="hobby" type="checkbox" checked="checked" value="2" />跑步

17. <input name="hobby" type="checkbox" value="3" />羽毛球

18. <input name="btn" id="btn" type="button" value="点击" />

19. </form>

对<form>元素进行序列化可以直接序列化其内部的所有表单元素。

1. var formArray = $("form").serializeArray();

2. /* 以下是序列化后的结果数组formArray的内容：

3. [

4. { name: "uid", value: "1" },

5. { name: "username", value: "张三" },

6. { name: "password", value: "123456" },

7. { name: "grade", value: "3" },

8. { name: "sex", value: "1" },

9. { name: "hobby", value: "1" },

10. { name: "hobby", value: "2" }

11. ];

12. */

我们也可以直接对部分表单元素进行序列化。

1. var result = $(":text, select, :checkbox").serializeArray();

2. /* 以下是序列化后的结果数组result的内容：

3. [

4. { name: "username", value: "张三" },

5. { name: "password", value: "123456" },

6. { name: "grade", value: "3" },

7. { name: "hobby", value: "1" },

8. { name: "hobby", value: "2" }

9. ];

10. */