jquery.form.js中文API博客分類(lèi)：
jQueryjQueryAjaxjsonPHP瀏覽器英文原文：http://www.malsup.com/jquery/form/#api
表單插件API提供了幾個(gè)方法，讓你輕松管理表單數(shù)據(jù)和進(jìn)行表單提交。
ajaxForm
增加所有需要的事件監(jiān)聽(tīng)器，為AJAX提交表單做好準(zhǔn)備。ajaxForm不能提交表單。在document的ready函數(shù)中，使用ajaxForm來(lái)為AJAX提交表單進(jìn)行準(zhǔn)備。ajaxForm接受0個(gè)或1個(gè)參數(shù)。這個(gè)單個(gè)的參數(shù)既可以是一個(gè)回調(diào)函數(shù)，也可以是一個(gè)Options對(duì)象。
可鏈接（Chainable）：可以。
實(shí)例：
Java代碼
$('#myFormId').ajaxForm();
ajaxSubmit
馬上由AJAX來(lái)提交表單。大多數(shù)情況下，都是調(diào)用ajaxSubmit來(lái)對(duì)用戶(hù)提交表單進(jìn)行響應(yīng)。ajaxSubmit接受0個(gè)或1個(gè)參數(shù)。這個(gè)單個(gè)的參數(shù)既可以是一個(gè)回調(diào)函數(shù)，也可以是一個(gè)Options對(duì)象。
可鏈接（Chainable）：可以。
實(shí)例：
Java代碼
// 綁定表單提交事件處理器
$('#myFormId').submit(function() {
// 提交表單
$(this).ajaxSubmit();
// 為了防止普通瀏覽器進(jìn)行表單提交和產(chǎn)生頁(yè)面導(dǎo)航（防止頁(yè)面刷新？）返回false
return false;
});
formSerialize
將表單串行化（或序列化）成一個(gè)查詢(xún)字符串。這個(gè)方法將返回以下格式的字符串：name1=value1&name2=value2。
可鏈接（Chainable）：不能， 這個(gè)方法返回一個(gè)字符串。
實(shí)例：
Java代碼
var queryString = $('#myFormId').formSerialize();
// 現(xiàn)在可以使用$.get、$.post、$.ajax等來(lái)提交數(shù)據(jù)
$.post('myscript.php', queryString);
fieldSerialize
將表單的字段元素串行化（或序列化）成一個(gè)查詢(xún)字符串。當(dāng)只有部分表單字段需要進(jìn)行串行化（或序列化）時(shí)，這個(gè)就方便了。這個(gè)方法將返回以下格式的字符串：name1=value1&name2=value2。
可鏈接（Chainable）：不能，這個(gè)方法返回一個(gè)字符串。
實(shí)例：
Java代碼
var queryString = $('#myFormId .specialFields').fieldSerialize();
fieldValue
返回匹配插入數(shù)組中的表單元素值。從0.91版起，該方法將總是以數(shù)組的形式返回?cái)?shù)據(jù)。如果元素值被判定可能無(wú)效，則數(shù)組為空，否則它將包含一個(gè)或多于一個(gè)的元素值。
可鏈接（Chainable）：不能，該方法返回?cái)?shù)組。
實(shí)例：
Java代碼
// 取得密碼輸入值
var value = $('#myFormId :password').fieldValue();
alert('The password is: ' + value[0]);
resetForm
通過(guò)調(diào)用表單元素原有的DOM方法，將表單恢復(fù)到初始狀態(tài)。
可鏈接（Chainable）：可以。
實(shí)例：
Java代碼
$('#myFormId').resetForm();
clearForm
清除表單元素。該方法將所有的文本（text）輸入字段、密碼（password）輸入字段和文本區(qū)域（textarea）字段置空，清除任何select元素中的選定，以及將所有的單選（radio）按鈕和多選（checkbox）按鈕重置為非選定狀態(tài)。
可鏈接（Chainable）：可以。
Java代碼
$('#myFormId').clearForm();
clearFields
清除字段元素。只有部分表單元素需要清除時(shí)才方便使用。
可鏈接（Chainable）：可以。
Java代碼
$('#myFormId .specialFields').clearFields();
Options對(duì)象
ajaxForm和ajaxSubmit都支持眾多的選項(xiàng)參數(shù)，這些選項(xiàng)參數(shù)可以使用一個(gè)Options對(duì)象來(lái)提供。Options只是一個(gè)JavaScript對(duì)象，它包含了如下一些屬性與值的集合：
target
指明頁(yè)面中由服務(wù)器響應(yīng)進(jìn)行更新的元素。元素的值可能被指定為一個(gè)jQuery選擇器字符串，一個(gè)jQuery對(duì)象，或者一個(gè)DOM元素。
默認(rèn)值：null。
url
指定提交表單數(shù)據(jù)的URL。
默認(rèn)值：表單的action屬性值
type
指定提交表單數(shù)據(jù)的方法（method）：“GET”或“POST”。
默認(rèn)值：表單的method屬性值（如果沒(méi)有找到默認(rèn)為“GET”）。
beforeSubmit
表單提交前被調(diào)用的回調(diào)函數(shù)。“beforeSubmit”回調(diào)函數(shù)作為一個(gè)鉤子（hook），被提供來(lái)運(yùn)行預(yù)提交邏輯或者校驗(yàn)表單數(shù)據(jù)。如果“beforeSubmit”回調(diào)函數(shù)返回false，那么表單將不被提交?！癰eforeSubmit”回調(diào)函數(shù)帶三個(gè)調(diào)用參數(shù)：數(shù)組形式的表單數(shù)據(jù)，jQuery表單對(duì)象，以及傳入ajaxForm/ajaxSubmit中的Options對(duì)象。表單數(shù)組接受以下方式的數(shù)據(jù)：
Java代碼
[ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]
默認(rèn)值：null
success
表單成功提交后調(diào)用的回調(diào)函數(shù)。如果提供“success”回調(diào)函數(shù)，當(dāng)從服務(wù)器返回響應(yīng)后它被調(diào)用。然后由dataType選項(xiàng)值決定傳回responseText還是responseXML的值。
默認(rèn)值：null
dataType
期望返回的數(shù)據(jù)類(lèi)型。null、“xml”、“script”或者“json”其中之一。dataType提供一種方法，它規(guī)定了怎樣處理服務(wù)器的響應(yīng)。這個(gè)被直接地反映到j(luò)Query.httpData方法中去。下面的值被支持：
'xml'：如果dataType == 'xml'，將把服務(wù)器響應(yīng)作為XML來(lái)對(duì)待。同時(shí)，如果“success”回調(diào)方法被指定， 將傳回responseXML值。
'json'：如果dataType == 'json'， 服務(wù)器響應(yīng)將被求值，并傳遞到“success”回調(diào)方法，如果它被指定的話。
'script'：如果dataType == 'script'， 服務(wù)器響應(yīng)將求值成純文本。
默認(rèn)值：null（服務(wù)器返回responseText值）
semantic
Boolean flag indicating whether data must be submitted in strict semantic order (slower). Note that the normal form serialization is done in semantic order with the exception of input elements of type="image". You should only set the semantic option to true if your server has strict semantic requirements and your form contains an input element of type="image".
布爾標(biāo)志，表示數(shù)據(jù)是否必須嚴(yán)格按照語(yǔ)義順序（slower？）來(lái)進(jìn)行提交。注意：一般來(lái)說(shuō)，表單已經(jīng)按照語(yǔ)義順序來(lái)進(jìn)行了串行化（或序列化），除了type="image"的input元素。如果你的服務(wù)器有嚴(yán)格的語(yǔ)義要求，以及表單中包含有一個(gè)type="image"的input元素，就應(yīng)該將semantic設(shè)置為true。（譯注：這一段由于無(wú)法理解，翻譯出來(lái)可能語(yǔ)不達(dá)意，但請(qǐng)達(dá)人指正。）
默認(rèn)值：false
resetForm
布爾標(biāo)志，表示如果表單提交成功是否進(jìn)行重置。
Default value: null
clearForm
布爾標(biāo)志，表示如果表單提交成功是否清除表單數(shù)據(jù)。
默認(rèn)值：null
實(shí)例：
Java代碼
// 準(zhǔn)備好Options對(duì)象
var options = {
target: '#divToUpdate',
url: 'comment.php',
success: function() {
alert('Thanks for your comment!');
} };
// 將options傳給ajaxForm
$('#myForm').ajaxForm(options);
注意：Options對(duì)象還可以用來(lái)將值傳遞給jQuery的$.ajax方法。如果你熟悉$.ajax所支持的options，你可以利用它們來(lái)將Options對(duì)象傳遞給ajaxForm和ajaxSubmit。
