1. 程式人生 > >jQuery form插件的使用--ajaxForm()和ajaxSubmit()的可選參數項對象

jQuery form插件的使用--ajaxForm()和ajaxSubmit()的可選參數項對象

data bmi 服務器 query eval 地址 int req htm

版權聲明:本文為博主原創文章,未經博主允許不得轉載。 https://blog.csdn.net/qq_38602656/article/details/78668924
  • 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; //阻止表單默認提交 });
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10

通過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;   //阻止表單默認提交
});
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37

表單提交之前進行驗證: 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;
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 參數介紹
    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

jQuery form插件的使用--ajaxForm()和ajaxSubmit()的可選參數項對象