jQuery form插件的使用--ajaxForm()和ajaxSubmit()的可選參數項對象
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()的可選參數項對象