假設現在有這樣一個用來添加用戶的表單:
<form id='addForm' action='UserAdd.action' type='post'> <label for='uname'>用戶名</label>:<input type='text' name='uname' id='uname'><br> <label for='mobileIpt'>手機號:</label><input type='text' name='mobileIpt' id='mobileIpt'><br> <label for='birthday'>生日:</label><input type='text' name='birthday'><br> <input type='button' value='提交' onclick='addUser()'> </form>
我們不想用表單 submit 的方式提交,而想用 ajax。以前是這樣寫的:
function addUser(){
var user = {
uname:$("#uname").val(),
mobileIpt:$("#mobileIpt").val(),
birthday:$("#birthday").val()
};
$.ajax({
url:'UserAdd.action',
data:user,
type:'post',
dataType:'text',
success:function(msg){
if(msg=='1'){ console.log('添加成功'); }
else{ console.log('添加失敗') }
}
})
}
這沒什麼錯,問題是逐一取值實在太麻煩——這裡只有三項,字段一多就崩潰了。
直到我發現了 jQuery 的 serializeArray 方法:
序列化表格元素(類似 .serialize() 方法),返回 JSON 數據結構。 注意:此方法返回的是 JSON 對象而非 JSON 字符串。 返回的 JSON 對象由一個對象數組組成,每個對象包含 name 與 value(value 不為空時)。
試試看:
$('#addForm').serializeArray();
//返回 json 數組,每個對象以 name 和 value 為 key
// [ {"name":"uname","value":""}, {"name":"mobileIpt","value":""}, {"name":"birthday","value":""} ]
這個好像用不上?我們再用 jQuery.param() 處理一下:
var arr = $('#addForm').serializeArray();
$.param(arr);
// "uname=alice&mobileIpt=110&birthday=1983-05-12"
这下符合需求了吧——雖然不是 json,但至少能作為 data 上傳了。其實我們可以直接在 ajax 的 data 處填上這個 json 數組,jQuery 內部會自己調用 $.param() 處理。
來看 jQuery.param() 的說明:
返回值:String
jQuery.param(obj,[traditional]) 將表單元素數組或者對象序列化。
obj,[traditional]:數組或 jQuery 對象按 name/value 序列化,普通對象按 key/value 序列化。
$.param({uanme:'vic',mobileIpt:'110',birthday:'2013-11-11'});
// "uanme=vic&mobileIpt=110&birthday=2013-11-11"
看著說明好像跟我們無關?換個 json 數組試試:
$.param([{uanme:'vic'},{mobileIpt:'110'},{birthday:'2013-11-11'}]);
// "undefined=&undefined=&undefined="
這個轉換失敗了。為什麼表單那種數據能成功轉成 url 參數?我們來看源碼:
//在 ajax() 方法中,對 json 類型的數據進行了 $.param() 處理
if ( s.data && s.processData && typeof s.data !== "string" ) {
s.data = jQuery.param( s.data, s.traditional );
}
//param 方法中
if ( jQuery.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
//序列化表單元素
jQuery.each( a, function() {
add( this.name, this.value );
});
} else {
//否則遞歸編碼參數
for ( prefix in a ) {
buildParams( prefix, a[ prefix ], traditional, add );
}
}
這下就明白了:如果是 json 數據(數組),就挨個循環只取 name 與 value 拼接字符串;如果是普通對象,就循環該對象的屬性再拼接。
所以,在 jQuery 的 ajax 函數中,data 可以傳入 3 種類型的數據:
1. 文本字符串:"uname=alice&mobileIpt=110&birthday=1983-05-12"
2. json 對象:{uanme:'vic',mobileIpt:'110',birthday:'2013-11-11'}
3. json 數組:
[ {"name":"uname","value":"alice"},
{"name":"mobileIpt","value":"110"},
{"name":"birthday","value":"2012-11-11"} ]
有了 serializeArray(),我們就能一鍵獲取表單並提交,非常方便。
補充:其實提取表單數據時,直接用 serialize() 方法獲取 "uname=alice&mobileIpt=110&birthday=1983-05-12" 這樣的字符串就可以了。