jQuery插件 -- Form表單插件jquery.form.js

jQuery Form插件是一個優秀的Ajax表單插件，能夠很是容易地、無侵入地升級HTML表單以支持Ajax。jQuery Form有兩個核心方法 -- ajaxForm() 和 ajaxSubmit()， 它們集合了從控制表單元素到決定如何管理提交進程的功能。另外，插件還包括其餘的一些方法： formToArray()、formSerialize()、fieldSerialize()、fieldValue()、clearForm()、clearFields() 和 resetForm()等。

下載地址： http://malsup.com/jquery/form/#download

核心方法 -- ajaxForm() 和 ajaxSubmit()

$('#myForm').ajaxForm(function() {
   $('#output1').html("提交成功！歡迎下次再來！").show();
});

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

$('#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;   //阻止表單默認提交
});

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;
}

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;
}