jQuery Form簡介

jQuery Form外掛是一個優秀的Ajax表單外掛，可以非常容易地、無侵入地升級HTML表單以支援Ajax。 
jQuery Form有兩個核心方法 – ajaxForm() 和 ajaxSubmit()， 它們集合了從控制表單元素到決定如何管理提交程序的功能。

下載地址

http://malsup.github.io/jquery.form.js

簡單介紹 
jQuery form外掛的使用–ajaxForm()和ajaxSubmit()的可選引數項物件。 
使用前引入JS檔案：

<script src="jquery.js" type="text/javascript"></script>
<script src="jquery.form.js" type="text/javascript"></script>
1
2
3
$('#myForm').ajaxForm(function() {   
   $('#output1').html("提交成功！歡迎下次再來！").show();    
});  

$('#myForm2').submit(function() {
   $(this).ajaxSubmit(function() {   
      $('#output2').html("提交成功！歡迎下次再來！").show();    
   });
   return false; //阻止表單預設提交
});
 

通過Form外掛的兩個核心方法，都可以在不修改表單的HTML程式碼結構的情況下，輕易地將表單的提交方式升級為Ajax提交方式

ajaxForm() 和 ajaxSubmit() 都能接受0個或1個引數，當為單個引數時，該引數既可以是一個回撥函式，也可以是一個options物件，上面的例子就是回撥函式，下面介紹options物件，使得它們對錶單擁有更多的控制權。

var options = {
   target: '#output',          //把伺服器返回的內容放入id為output的元素中    
   beforeSubmit: showRequest,  //提交前的回撥函式
   success: showResponse,      //提交後的回撥函式
   //url: url,                 //預設是form的action， 如果申明，則會覆蓋
   //type: type,               //預設是form的method（get or post），如果申明，則會覆蓋
   //dataType: null,           //html(預設), xml, script, json...接受服務端返回的型別
   //clearForm: true,          //成功提交後，清除所有表單元素的值
   //resetForm: true,          //成功提交後，重置所有表單元素的值
   timeout: 3000               //限制請求的時間，當請求大於3秒後，跳出請求
}

function showRequest(formData, jqForm, options){
   //formData: 陣列物件，提交表單時，Form外掛會以Ajax方式自動提交這些資料，格式如：[{name:user,value:val },{name:pwd,value:pwd}]
   //jqForm:   jQuery物件，封裝了表單的元素   
   //options:  options物件
   var queryString = $.param(formData);   //name=1&address=2
   var formElement = jqForm[0];              //將jqForm轉換為DOM物件
   var address = formElement.address.value;  //訪問jqForm的DOM元素
   return true;  //只要不返回false，表單都會提交,在這裡可以對錶單元素進行驗證
};

function showResponse(responseText, statusText){
   //dataType=xml
   var name = $('name', responseXML).text();
   var address = $('address', responseXML).text();
   $("#xmlout").html(name + "  " + address);
   //dataType=json
   $("#jsonout").html(data.name + "  " + data.address);
};

$("#myForm").ajaxForm(options);

$("#myForm2").submit(funtion(){
   $(this).ajaxSubmit(options);
   return false;   //阻止表單預設提交
});
 

表單提交之前進行驗證： beforeSubmit會在表單提交前被呼叫，如果beforeSubmit返回false，則會阻止表單提交

beforeSubmit: validate
function validate(formData, jqForm, options) { //在這裡對錶單進行驗證，如果不符合規則，將返回false來阻止表單提交，直到符合規則為止
   //方式一：利用formData引數
   for (var i=0; i < formData.length; i++) {
       if (!formData[i].value) {
            alert('使用者名稱,地址和自我介紹都不能為空!');
            return false;
        }
    } 

   //方式二：利用jqForm物件
   var form = jqForm[0]; //把表單轉化為dom物件
      if (!form.name.value || !form.address.value) {
            alert('使用者名稱和地址不能為空，自我介紹可以為空！');
            return false;
      }

   //方式三：利用fieldValue()方法，fieldValue 是表單外掛的一個方法，它能找出表單中的元素的值，返回一個集合。
   var usernameValue = $('input[name=name]').fieldValue();
   var addressValue = $('input[name=address]').fieldValue();
   if (!usernameValue[0] || !addressValue[0]) {
      alert('使用者名稱和地址不能為空，自我介紹可以為空！');
      return false;
   }

    var queryString = $.param(formData); //組裝資料
    //alert(queryString); //類似 ： name=1&add=2  
    return true;
}
 

引數介紹 
ajaxForm()和ajaxSubmit()的可選引數項物件：

ajaxForm 和 ajaxSubmit 都支援大量的可選引數，它們通過可選引數項物件傳入。可選引數項物件只是一個簡單的 JavaScript物件，裡邊包含了一些屬性和一些值: 
target 
用server端返回的內容更換指定的頁面元素的內容。 這個值可以用jQuery 選擇器來表示, 或者是一個jQuery 物件， 一個 DOM 元素。 
預設值： null 
url 
表單提交的地址。 
預設值： 表單的action的值 
type 
表單提交的方式，’GET’ 或 ‘POST’. 
預設值： 表單的 method 的值 (如果沒有指明則認為是 ‘GET’) 
beforeSubmit 
表單提交前執行的方法。 
這個可以用在表單提交前的預處理，或表單校驗。 
如果’beforeSubmit’指定的函式返回false，則表單不會被提交。 ‘beforeSubmit’函式呼叫時需要3個引數：陣列形式的表單資料，jQuery 物件形式的表單物件，可選的用來傳遞給ajaxForm/ajaxSubmit 的物件。 
陣列形式的表單資料是下面這樣的格式：[ { name: ‘username’, value: ‘jresig’ }, { name: ‘password’, value: ‘secret’ } ] 
預設值： null 
success 
當表單提交後執行的函式。 如果’success’ 回撥函式被指定，當server端返回對錶單提交的響應後，這個方法就會被執行。 responseText 和 responseXML 的值會被傳進這個引數 (這個要依賴於dataType的型別). 
預設值： null 
dataType 
指定伺服器響應返回的資料型別。其中之一: null, ‘xml’, ‘script’, 或者 ‘json’. 這個 dataType 選項用來指示你如何去處理server端返回的資料。 這個和 jQuery.httpData 方法直接相對應。 
下面就是可以用的選項： 
‘xml’: 如果 dataType == ‘xml’ 則 server 端返回的資料被當作是 XML 來處理， 這種情況下’success’指定的回撥函式會被傳進去 responseXML 資料 
‘json’: 如果 dataType == ‘json’ 則server端返回的資料將會被執行，並傳進’success’回撥函式 
‘script’: 如果 dataType == ‘script’ 則server端返回的資料將會在上下文的環境中被執行 
預設值： null 
semantic 
一個布林值，用來指示表單裡提交的資料的順序是否需要嚴格按照語義的順序。一般表單的資料都是按語義順序序列化的，除非表單裡有一個type=”image”元素. 所以只有當表單裡必須要求有嚴格順序並且表單裡有type=”image”時才需要指定這個。 
預設值： false 
resetForm 
布林值，指示表單提交成功後是否需要重置。 
預設值： null 
clearForm 
布林值，指示表單提交成功後是否需要清空。 
預設值： null 
iframe 
布林值，用來指示表單是否需要提交到一個iframe裡。 這個用在表單裡有file域要上傳檔案時。更多資訊請參考 程式碼示例 頁面裡的File Uploads 文件。 
預設值： false
--------------------- 
原文：https://blog.csdn.net/qq_38602656/article/details/78668924