您的位置:首页 > Web前端 > JQuery

jquery form plugin( ajax表单提交 )

2011-08-11 08:54 543 查看
http://www.aqee.net/docs/jquery.form.plugin/jquery.form.plugin.html#getting-started

用ajax表单提交的好处就是可以实现异步处理和局部刷新。(不知道新的java 7提供的异步处理API如何工作。)

ajaxForm
预处理将要使用AJAX方式提交的表单,将所有需要用到的事件监听器添加到其中。可有一个参数。

$('#myFormId').ajaxForm();


ajaxSubmit
立即通过AJAX方式提交表单。最常见的用法是对用户提交表单的动作进行响应时调用它。可有一个参数。

// attach handler to form's submit event
$('#myFormId').submit(function() {
// submit the form
$(this).ajaxSubmit();
// return false,这样可以阻止正常的浏览器表单提交和页面转向
return false;
});


可选参数:

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


EXAMPLE:
var options = {
target:     '#divToUpdate',
url:        'comment.php',
success:    function() {
alert('Thanks for your comment!');
}
};

// pass options to ajaxForm
$('#myForm').ajaxForm(options);
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: