jquery-form是什麼

2022-05-16 13:00:19

jquery-form是指jQuery表單庫,是一個表單非同步提交外掛,可容易地、無侵入地升級HTML表單以支援Ajax;該外掛有兩個核心方法:ajaxForm()和ajaxSubmit(),集合了從控制表單元素到決定如何管理提交程序的功能。

本教學操作環境:windows7系統、jquery3.3.1版本、Dell G3電腦。

jquery-form是什麼

jquery-form是指jQuery表單庫,是一個基於jQuery的表單非同步提交外掛,用於處理表單AJAX提交,使得表單AJAX提交簡單、容易,且能完整控制提交過程和處理結果,不需要任何特殊標籤輔助,不影響原表單結構,只要使用該庫就能使普通表單平滑升級為ajax提交表單。

外掛優點

  • 簡簡單單幾句程式碼,我們就可以實現表單的提交,並且可靈活通過ajaxSubmit()函數基於任何事件的觸發實現表單非同步提交。

  • 支援檔案上傳功能,並在新瀏覽器中支援進度條更新。

  • 與jQuery庫完美結合,支援jQuery.ajax()函數觸發的各種事件,支援jQuery.ajax()中所傳遞的引數。

jquery-form可以非常容易地、無侵入地升級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; //阻止表單預設提交
});

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

【推薦學習:、】

以上就是jquery-form是什麼的詳細內容,更多請關注TW511.COM其它相關文章!