英文原文：http://www./jquery/form/#api 

表單插件API提供了幾個方法，讓你輕松管理表單數(shù)據(jù)和進(jìn)行表單提交。 

ajaxForm 

增加所有需要的事件監(jiān)聽器，為AJAX提交表單做好準(zhǔn)備。ajaxForm不能提交表單。在document的ready函數(shù)中，使用ajaxForm來為AJAX提交表單進(jìn)行準(zhǔn)備。ajaxForm接受0個或1個參數(shù)。這個單個的參數(shù)既可以是一個回調(diào)函數(shù)，也可以是一個Options對象。 
可鏈接（Chainable）：可以。 

實(shí)例： 



ajaxSubmit 

馬上由AJAX來提交表單。大多數(shù)情況下，都是調(diào)用ajaxSubmit來對用戶提交表單進(jìn)行響應(yīng)。ajaxSubmit接受0個或1個參數(shù)。這個單個的參數(shù)既可以是一個回調(diào)函數(shù)，也可以是一個Options對象。 
可鏈接（Chainable）：可以。 

實(shí)例： 




formSerialize 

將表單串行化（或序列化）成一個查詢字符串。這個方法將返回以下格式的字符串：name1=value1&name2=value2。 
可鏈接（Chainable）：不能， 這個方法返回一個字符串。 

實(shí)例： 



fieldSerialize 

將表單的字段元素串行化（或序列化）成一個查詢字符串。當(dāng)只有部分表單字段需要進(jìn)行串行化（或序列化）時，這個就方便了。這個方法將返回以下格式的字符串：name1=value1&name2=value2。 
可鏈接（Chainable）：不能，這個方法返回一個字符串。 

實(shí)例： 



fieldValue 

返回匹配插入數(shù)組中的表單元素值。從0.91版起，該方法將總是以數(shù)組的形式返回數(shù)據(jù)。如果元素值被判定可能無效，則數(shù)組為空，否則它將包含一個或多于一個的元素值。 
可鏈接（Chainable）：不能，該方法返回數(shù)組。 

實(shí)例： 



resetForm 

通過調(diào)用表單元素原有的DOM方法，將表單恢復(fù)到初始狀態(tài)。 
可鏈接（Chainable）：可以。 

實(shí)例： 



clearForm 

清除表單元素。該方法將所有的文本（text）輸入字段、密碼（password）輸入字段和文本區(qū)域（textarea）字段置空，清除任何select元素中的選定，以及將所有的單選（radio）按鈕和多選（checkbox）按鈕重置為非選定狀態(tài)。 
可鏈接（Chainable）：可以。 



clearFields 

清除字段元素。只有部分表單元素需要清除時才方便使用。 
可鏈接（Chainable）：可以。 



Options對象 

ajaxForm和ajaxSubmit都支持眾多的選項(xiàng)參數(shù)，這些選項(xiàng)參數(shù)可以使用一個Options對象來提供。Options只是一個JavaScript對象，它包含了如下一些屬性與值的集合： 

target 

指明頁面中由服務(wù)器響應(yīng)進(jìn)行更新的元素。元素的值可能被指定為一個jQuery選擇器字符串，一個jQuery對象，或者一個DOM元素。 
默認(rèn)值：null。 

url 

指定提交表單數(shù)據(jù)的URL。 
默認(rèn)值：表單的action屬性值 

type 

指定提交表單數(shù)據(jù)的方法（method）：“GET”或“POST”。 
默認(rèn)值：表單的method屬性值（如果沒有找到默認(rèn)為“GET”）。 

beforeSubmit 

表單提交前被調(diào)用的回調(diào)函數(shù)?！癰eforeSubmit”回調(diào)函數(shù)作為一個鉤子（hook），被提供來運(yùn)行預(yù)提交邏輯或者校驗(yàn)表單數(shù)據(jù)。如果“beforeSubmit”回調(diào)函數(shù)返回false，那么表單將不被提交?！癰eforeSubmit”回調(diào)函數(shù)帶三個調(diào)用參數(shù)：數(shù)組形式的表單數(shù)據(jù)，jQuery表單對象，以及傳入ajaxForm/ajaxSubmit中的Options對象。表單數(shù)組接受以下方式的數(shù)據(jù)： 




默認(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ù)類型。null、“xml”、“script”或者“json”其中之一。dataType提供一種方法，它規(guī)定了怎樣處理服務(wù)器的響應(yīng)。這個被直接地反映到j(luò)Query.httpData方法中去。下面的值被支持： 

'xml'：如果dataType == 'xml'，將把服務(wù)器響應(yīng)作為XML來對待。同時，如果“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)格按照語義順序（slower？）來進(jìn)行提交。注意：一般來說，表單已經(jīng)按照語義順序來進(jìn)行了串行化（或序列化），除了type="image"的input元素。如果你的服務(wù)器有嚴(yán)格的語義要求，以及表單中包含有一個type="image"的input元素，就應(yīng)該將semantic設(shè)置為true。（譯注：這一段由于無法理解，翻譯出來可能語不達(dá)意，但請達(dá)人指正。） 
默認(rèn)值：false 

resetForm 

布爾標(biāo)志，表示如果表單提交成功是否進(jìn)行重置。 
Default value: null 

clearForm 

布爾標(biāo)志，表示如果表單提交成功是否清除表單數(shù)據(jù)。 
默認(rèn)值：null 

實(shí)例： 



注意：Options對象還可以用來將值傳遞給jQuery的$.ajax方法。如果你熟悉$.ajax所支持的options，你可以利用它們來將Options對象傳遞給ajaxForm和ajaxSubmit。