ajaxForm()和ajaxSubmit()方法可以接受0个或1个参数,当为单个参数时,该参数可以是一个回调函数,也可以是一个options对象。以下是一个options对象.
var options={
target:'#output1', //把服务器返回内容放入id为output1的元素中
beforeSubmit:showRequest, //提交前的回调函数
success:showResponse, //提交后的回调函数
//url:url, //默认是form的action,如果申明,则会覆盖
//type:type, //默认是form的method('get' or 'post'),如果申明,则会覆盖
//dateType:null, //'xml','script',or 'json'(接受服务端返回的类型)
//clearForm:true, //成功提交后,清除所有表单元素的值
//resetForm:true, //成功提交后,重置所有表单的值
//timeout:3000 //限制请求的时间,当请求大于3秒后,跳出请求
定义上面options后,就可以把此对象传递给ajaxForm()方法,
$("#myForm").ajaxForm(options);
$("#myForm").submit(function(){
$(this).ajaxSubmit(options);
return false;
在以上options中指定了两个回调函数,即beforeSubmit:showRequest和success:showResponse
各函数参数如下:
funtion showRequest(formData,jqForm,options){
var queryString = $.param(formData);
return true;
此回调函数有三个参数.
第1个参数formdata是数组对象[{name:myname},{value:myvalue}],在这里,使用$.param()方法把它转化为字符串,得到类似"name=1&address=2",需要注意的是当表单提交时,form插件会以Ajax的方式自动提交这些数据.
第2个参数jqForm是一个jQuery对象,它封装了表单的元素,如果需要访问jqForm的dom元素,可以把jqForm转换为DOM对象。
var formElement = jqForm[0];
var address = formElement.address.value;
第3个参数options就是options对象,前面已经声明了options对象里的一些属性,其它没有声明的,则会使用默认的属性。
在这个回调函数中,只要不返回false,表单都将被允许提交,如果返回false,则会阻止表单提交,可以利用这个特性,在表单提交前验证数据,如果不符合验证规则,则阻止表单提交。
以下讲三种表单验证方式:
a,利用参数formData,formData是一个数组对象,数据格式如下:[{name:name,value:nameValue},{name:password,value:passwordValue}]
由于是数组,可循环来获取每个元素的值,然后判断元素的值是否符合验证规则(这里只判断元素是否为空),如果有一项不符合验证规则,就返回false,来阻止表单提交,代码如下:
function validate(formData,jqForm,options){
for(var i =0;i<formData.length;i++){
if(!formData[i].value){
alert('用户名,地址和自我介绍都不能为空!');
return false;
var queryString = $.param(formData);
return true;
b,利用jqForm,不仅可以利用第一个参数formData来获取表单数据,而且可以用第二个参数jqForm来达到同样的效果.
参数jqForm是一个jQuery对象,它封装了表单的元素,如果需要访问jqForm的DOM元素,可以把jqForm转为DOM对象。
var form = jqForm[0];
然后通过form.name.value来获取用户名的值;通过form.address.value来获取地址的值.
代码如下:
function validate(formData,jqForm,options){
var form = jqForm[0];
if(!form.name.value || !form.address.value){
alert('用户名和地址不能为空,自我介绍可以为空!');
return false;
var queryString = $.param(formData);
return true;
c:利用fieldValue()方法
fieldValue()方法会把匹配元素的值插入到数组中,然后返回这个数组,如果表单元素的值被判定无效,则数组为空,否则数组将包含一个或多个元素的值,由于返回的是一个数据,而不是jQuery对象,因此不能进行链式操作。
利用fieldValue()方法,也能很容易地获取到表单元素的值,例如可以通过$("input[name=address]").fieldValue()来获取name为address的input元素的值的“数组集合”。然后通过数组下标来获取数组中对应的值。
代码如下:
function validate(formData,jqForm,options){
var usernameValue = $('input[name=name]').fieldValue();
var addressValue = $('input[name=address]').fieldValue();
if(!usernameValue[0] || !addressValue[0]){
alert('用户名和地址不能为空,自我介绍可以为空!');
return false;
var queryString = $.param(formData);
return true;
sussess……提交后的回调函数:
function showResponse(responseText,statusText){
alert('状态:'+statusText+'\n 返回的内容是:\n'+responseText);
statusText只是一个返回状态,如:success,error等.
responseText携带着服务器返回的数据内容,responseText会根据设置的options对象中的dateType属性来返回相应格式的内容.具体情况如下。
1,对于缺省的html返回,回调函数的第一个参数是XMLHttpRequest对象的responseText属性;
2,当dataType属性被设置为xml时,回调函数的第一个参数是XMLHttpRequest对象的responseXML属性;
例如声明服务器返回数据的类型为xml,然后以XML方式解析数据,代码如下:
$("#xmlForm").ajaxForm({
dataType:'xml',
success:processXml
function processXml(responseXML){
var name = $('name',responseXML).text();
var address = $('address',responseXML).text();
$("#xmlOut").html(name+" "+address);
3,当dataType属性被设置为json时,回调函数的第1个参数是从服务器返回的json数据对象,如:
$('myForm').ajaxForm({
dataType:'json',
success:processJson
function processJson(data){
$('#jsonOut').html(data.name+' ' + data.address);