要一次把表單資料送出去,serialize() 是最省事的做法。這篇從定義講到 param 與 serializeArray 的底層實作。
$(selector).serialize()
serialize() 會把表單元素集合序列化成標準的 URL 編碼字串,非常適合直接塞進 Ajax 請求的 query string。你可以選 input、textarea 等單一元素,也可以直接選 form 本身。
幾個實務上要注意的點:
<form id="form1">
<input name="length" type="text" value="pipi" />
<input name="blog" type="text" value="blue submarine" />
</form>
// 使用
$("#form1").serialize();
因為 length 撞上了關鍵字,這段就拿不到預期的值。
1. 搭配 Ajax 送出
$.ajax({
type: "POST",
dataType: "json",
url: ajaxCallBack,
data: $('#myForm').serialize(), // 要提交表單的 ID
success: function (msg) {
alert(msg);
}
});
2. 單純序列化看看結果
<script src="jquery-1.7.min.js"></script>
<script>
$(function () {
$("#submit").click(function () {
alert($("#myForm").serialize());
});
});
</script>
<form id="myForm">
昵稱 <input type="text" name="username" value="admin" /><br />
密碼 <input type="password" name="password" value="admin123" /><br />
<input type="button" id="submit" value="序列化表單" />
</form>
點擊後會彈出:
username=admin&password=admin123
serialize() 其實是 serializeArray() 加上 param() 的包裝。
1. $.param()——serialize() 的核心,負責把陣列或物件按 key/value 序列化:
param: function (a) {
var s = [];
function add(key, value) {
s[s.length] = encodeURIComponent(key) + '=' + encodeURIComponent(value);
};
// 傳入陣列時,視為表單元素集合
if (jQuery.isArray(a) || a.jquery)
jQuery.each(a, function () {
add(this.name, this.value);
});
// 否則視為 key/value 物件
else
for (var j in a)
if (jQuery.isArray(a[j]))
jQuery.each(a[j], function () {
add(j, this);
});
else
add(j, jQuery.isFunction(a[j]) ? a[j]() : a[j]);
return s.join("&").replace(/%20/g, "+");
}
用起來就是:
var obj = { a: 1, b: 2, c: 3 };
var k = $.param(obj);
alert(k); // 輸出 a=1&b=2&c=3
2. serializeArray()——把表單各欄位序列化成陣列:
serializeArray: function () {
return this.map(function () {
return this.elements ? jQuery.makeArray(this.elements) : this;
})
.filter(function () {
return this.name && !this.disabled &&
(this.checked || /select|textarea/i.test(this.nodeName) ||
/text|hidden|password|search/i.test(this.type));
})
.map(function (i, elem) {
var val = jQuery(this).val();
return val == null ? null :
jQuery.isArray(val) ?
jQuery.map(val, function (val, i) {
return { name: elem.name, value: val };
}) :
{ name: elem.name, value: val };
}).get();
}
輸出的資料結構長這樣:
[ {
name : username,
value : 中國
}, {
name : password,
value : xxx
}]
理解這一層之後,要客製序列化規則(例如加上前綴、排除特定欄位)就只是自己組字串的問題了。
希望這篇對大家的 jQuery 開發有幫助。