Form插件地址:
官方网站:http://malsup.com/jQuery/form/
翻译地址:http://www.aqee.net/docs/jquery.form.plugin/jquery.form.plugin.html#getting-started
一.准备工作
写一个表单:
<form id="reg" action="123.php" method="post">
<p>
<label for="user">账号:</label>
<input type="text" name="user" class="text" id="user" title="" />
</p>
<p>
<label for="pass">密码:</label>
<input type="password" name="pass" class="text" id="pass" />
</p>
<input type="submit" value="Submit Comment" />
</form>
引入jQuery和Form Plugin Javascript脚本文件:
<script type="text/javascript" src="path/to/jquery.js"></script> <script type="text/javascript" src="path/to/form.js"></script>
二.核心方法
form.js 插件有两个核心方法:ajaxForm()和 ajaxSubmit(),它们集合了从控制表单元素到决定如何管理提交进行的功能。
ajaxForm
预处理将要使用AJAX方式提交的表单,将所有需要用到的事件监听器添加到其中。它不是提交这个表单。 在页面的ready
函数里使用ajaxForm
来给你页面上的表单做这些AJAX提交的准备工作。 ajaxForm
需要零个或一个参数。这唯一的一个参数可以是一个回调函数或者是一个可选参数对象。
//ajaxForm 提交方式 $('#reg').ajaxForm(function () { alert('提交成功!'); });
注意:使用 ajaxForm()方法,会直接实现 ajax 提交。自动阻止了默认行为,而它提交的默认页面是 form 控件的 action 属性的值。提交的方式是 method 属性的值。
ajaxSubmit
立即通过AJAX方式提交表单。最常见的用法是对用户提交表单的动作进行响应时调用它。 ajaxForm
需要零个或一个参数。唯一的一个参数可以是一个回调函数或者是一个可选参数对象。
//ajaxSubmit()提交方式 $('#reg').submit(function () { $(this).ajaxSubmit(function () { alert('提交成功!'); }); return false; //ajaxSubmit不会自动阻止默认提交,需要自行阻止。这里阻止默认直接提交行为 });
注意: ajaxForm()方法,是针对 form 直接提交的, 所以阻止了默认行为。而 ajaxSubmit()方法,由于是针对 submit()方法的,所以需要手动阻止默认行为。而使用了 validate.js 验证插件,那么 ajaxSubmit()比较适合我们。
疑问:ajaxForm()与ajaxSubmit()的区别:
答案:$("#form1").ajaxForm(); 相当于以下两行:
$("#form1".submit)(function(){
$("#form1").ajaxSubmit();
return false;
}) //也就是说ajaxFrom()会自动阻止表单提交。而ajaxSubmit()不会自动阻止表单提交,想阻止表单提交,要自己return false;
三.可选参数项对象
ajaxForm
和 ajaxSubmit
都支持大量的可选参数,它们通过可选参数项对象传入。可选参数项对象只是一个简单的 JavaScript对象,里边包含了一些属性和一些值:
$("#reg").submit(function() { $(this).ajaxSubmit({ url : "123.php", //设置提交的 url,可覆盖 action 属性 target : "#box", //服务器返回的内容存放在#box里 type : "GET", dateType : null, //xml,json,script,默认为 null //clearForm : true, //成功提交后,清空表单 //resetForm : true, //成功提交后,重置表单 data : { //增加额外的数据提交 aaa : 'bbb', ccc : 'ddd' }, beforeSubmit : function(formData, jqForm, options){//提交数据之前执行,一般用于数据验证 //如果数据验证不合法,就返回false,不让提交.默认为true //alert(formData[0].name); //得到传递表单元素的 name // alert(formData[0].value); //得到传递表单元素的 value //alert(jqForm[0].user.value); //得到 form 的 jquery 对象 //alert(options.url); //得到目前 options 设置的属性 return true; }, success : function(responseText,statusText) { //成功时回调 alert(responseText + statusText); // alert('Thanks for your comment!'); }, error : function(event, errorText, errorType){ //错误时回调 alert(errorText + errorType); }, }); return false; });
四.工具方法
form.js 除了提供两个核心方法之外,还提供了一些常用的工具方法。这些方法主要是在提交前或后对数据或表单进行处理的。
//表单序列化 alert($('#reg').formSerialize()); //序列化某一个字段 alert($('#reg #user').fieldSerialize()); //得到某个字段的 value 值 alert($('#reg #user').fieldValue()); //重置表单 $('#reg').resetForm() //清空某个字段 $('#reg #user').clearFields();