jQuery Form Plugin ,二 :使用AJAX提交Form表单

前章介绍了使 用AJAX提交Form表单的方法,其中主要的就是ajaxForm()和ajaxSubmit(),ajaxForm和ajaxSubmit都支持众多 的选项参数,这些选项参数可以使用一个Options对象来提供。Options只是一个JavaScript对象,它包含了如下一些属性与值的集合:

Options对象的详解:

1.)target

指明页面中由服务器响应进行更新的元素。元素的值可能被指定为一个jQuery选择器字符串,一个jQuery对象,或者一个DOM元素。

默认值:null。

2.)url

重写或者指定表单的'action'属性。

默认值:表单的action属性值

3.)type

重写或者指定表单的'method' 属性,"GET"或"POST"。

默认值:表单的method属性值(如果没有找到默认为“GET”)。

4.)beforeSubmit

表单提交前被调用的回调函数,该方法通常被提供来运行预提交逻辑或者校验表单数据。如果"beforeSubmit"回调函数返回false,那么表单将 不被提交。"beforeSubmit"回调函数带三个调用参数:数组形式的表单数据,jQuery表单对象,以及传入 ajaxForm/ajaxSubmit中的Options对象。表单数组接受以下方式的数据:

[ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]

默认值:null

5.)success

表单成功提交后调用的回调函数。如果提供"success"回调函数,当从服务器返回响应后它被调用。然后由dataType选项值决定传回responseText还是responseXML的值。

默认值:null

6.)dataType

期望服务器的的回应的类型。null、"xml"、"script"或者"json"其中之一。dataType提供一种方法,它规定了怎样处理服务器的响应。这个被直接地反映到jQuery.httpData方法中去。下面的值被支持:

'xml':如果dataType == 'xml',将把服务器响应作为XML来对待。同时,如果“success”回调方法被指定,将传回responseXML值

'json':如果dataType == 'json', 服务器响应将被求值,并传递到“success”回调方法,如果它被指定的话。

'script':如果dataType == 'script', 服务器响应将求值成纯文本。

默认值:null(服务器返回responseText值)

7.)semantic

布尔标志,表示数据是否必须严格按照语义顺序来进行提交。注意:一般来说,表单已经按照语义顺序来进行了串行化(或序列化),除了 type="image"的input元素。如果你的服务器有严格的语义要求,以及表单中包含有一个type="image"的input元素,就应该将 semantic设置为true。

默认值:false

8.)resetForm

布尔标志,表示如果表单提交成功是否进行重置。

默认值:null

9.)clearForm

布尔标志,表示如果表单提交成功是否清除表单数据。

默认值:null

10.)在$.ajax options中用到的元素都可以用在这里:

如:timeout:3000

ajaxSubmit示例代码:

<%@ page language="java" pageEncoding="UTF-8"%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head>

<title>My Jquery</title>

<script type="text/javascript" src="<%=request.getContextPath()%>/jslib/jquery-1.4.2.js"></script>

<script type="text/javascript" src="<%=request.getContextPath()%>/jslib/jquery.form.js"></script>

<script type="text/javascript">

$().ready(function() {

var options = {

target: '#output2',

beforeSubmit: showRequest,

success: showResponse

};

$('#myForm2').submit(function() {

$(this).ajaxSubmit(options);

return false;

});

});

// pre-submit callback

/**参数介绍

formData:是一个数组,我们使用$.param来把它转化成字符串显示,form提交的时候该插件可以自动为你转换;

jqForm:是一个jQuery对象,用来封装form元素,访问DOM元素可以这样:var formElement = jqForm[0];

   options:就是上面ajaxSubmit()中的Options对象;

**/

function showRequest(formData, jqForm, options) {

var queryString = $.param(formData);

alert('About to submit: \n\n' + queryString);

return true;

}

// post-submit callback

/**参数介绍

responseText:

通常作为html的相应,方法成功回调,XMLHttpRequest对象的responseText属性,

如果Options对象的dataType属性设置'xml'的话,该参数就是XMLHttpRequest对象的responseXML属性,

如果Options对象的dataType属性设置'json' 的话,该参数就是服务器返回的JSON对象 ;

statusText:状态码;

   xhr:XMLHttpRequest对象;

$form:;

**/

function showResponse(responseText, statusText, xhr, $form) {

alert('status: ' + statusText + '\n\nresponseText: \n' + responseText);

}

</script>

</head>

<body>

<form ></div>

</body>

</html>