在 jQuery 中,當我們使用 ajax 時,往往需要把表單資料以鍵值對(Key/Value)的形式送出到伺服器。所幸 jQuery 提供了 serialize() 方法,能輕鬆完成這項工作——它可以把表單序列化成 key1=value1&key2=value2… 這樣的字串後再提交。下面就來詳細介紹 serialize() 的用法與背後原理。
serialize() 方法透過序列化表單值,建立標準的 URL 編碼文字字串,它的操作對象是代表表單元素集合的 jQuery 物件。你可以選擇一個或多個表單元素(例如 input 或 textarea),或直接選擇 form 元素本身。序列化後的值可用於產生 AJAX 請求時的 URL 查詢字串。
語法:
程式碼如下:
$(selector).serialize()
詳細說明:
1、.serialize() 方法建立以標準 URL 編碼表示的文字字串,操作對象是代表表單元素集合的 jQuery 物件。
2、.serialize() 可以操作已選取的個別表單元素,例如 <input>、<textarea> 以及 <select>。不過,直接選擇 <form> 標籤本身來序列化通常更為省事。
3、它只會把「成功的控件」序列化為字串。若不使用按鈕來提交表單,則不會序列化提交按鈕的值。此外,表單元素要能被序列化,必須具備 name 屬性。
4、form 裡面的 name 不要使用 JS 或 jQuery 的關鍵字,例如 length。
例如:
程式碼如下:
<form id="form1">
<input name="length" type="text" value="pipi" />
<input name="blog" type="text" value="blue submarine" />
</form>
//使用:$("#form1").serialize();
上面這段程式碼就取不到值。
1、ajax 搭配 serialize():
程式碼如下:
$.ajax({
type: "POST",
dataType: "json",
url:ajaxCallBack,
data:$('#myForm').serialize(),// 要提交表單的ID
success: function(msg){
alert(msg);
}
});
2、serialize() 序列化表單:
程式碼如下:
<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
1、$.param():$.param() 方法是 serialize() 的核心,用來把一個陣列或物件按 key/value 進行序列化。
param 方法的 JS 程式碼:
程式碼如下:
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 );
});
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 方法是把表單中的各個欄位序列化成一個陣列。
serializeArray 方法的 jQuery 定義:
程式碼如下:
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();
}
serializeArray 的資料範例:
程式碼如下:
[ { name : username, value : 中國 }, { name : password, value : xxx }]
以上就是本文所述的全部內容,希望對大家在處理表單序列化時能有所幫助。