首页 > 代码库 > jQuery.form.js使用

jQuery.form.js使用

jQuery.form.js是一个form插件,支持ajax表单提交和ajax文件上传。

下载地址

百度云:http://pan.baidu.com/s/1eQoYE46

360云:http://yunpan.cn/Qi7B5wdiewUMP  访问密码 06b6

微云:http://url.cn/QMQ79w

 1 <!DOCTYPE html>
 2 
 3 <html>
 4 <head>
 5     <meta name="viewport" content="width=device-width" />
 6     <title>Index</title>
 7     <script src="~/Scripts/jquery-1.6.2.js"></script>
 8     <script src="~/Scripts/jQuery.form.js"></script>
 9 </head>
10 <body>
11     <div>
12         <form id="ajaxForm" method="post" action="/Home/Index" enctype="multipart/form-data">
13             <input type="text" name="name" />
14             <input type="text" name="sex" />
15             <input type="file" name="file" />
16             <button type="submit" id="btnSubmit">提交1</button>
17         </form>
18         <button id="btnButton" type="button">提交2</button>
19     </div>
20     <script type="text/javascript">
21         $(function () {
22             $("#ajaxForm").ajaxForm(function () {
23                 alert("提交成功1");
24             });
25             $("#ajaxForm").submit(function () {
26                 $(this).ajaxSubmit(function () {
27                     alert("提交成功1");
28                 });
29                 return false;
30             });
31             $("#btnButton").click(function () {
32                 $("#ajaxForm").ajaxSubmit(function () {
33                     alert("提交成功2");
34                 });
35                 return false;
36             });
37         });
38     </script>
39 </body>
40 </html>
View Code

API

ajaxForm 增加所有需要的事件监听器,为ajax提交表单做准备。ajaxForm并不能提交表单。在document的ready函数中,使用ajaxForm来为ajax提交表单进行准备。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个Options对象。 $("#formid").ajaxForm();
ajaxSubmit 使用ajax提交表单。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个Options对象。

$("#formid").ajaxSubmit();

$("#formid").submit(function(){

    $(this).ajaxSubmit();

    return false;

});

formSerialize 将表单串行化(或序列化)为一个查询字符串。这个方法将返回以下格式的字符串:name1=value1&name2=value2。 $("#formid").formSerialize();
fieldSerialize 将表单的字段元素串行化(或序列化)为一个查询字符串。当只有部分表单字段需要进行串行化(或序列化)时,使用这个就很方便了。返回以下格式的字符串:name=value1&name2=value2。 $("#formid .specialFields").fieldSerialize();
fieldValue 返回匹配插入数组中的表单元素值。该方法以数组的形式返回数据。如果元素值被判定可能无效,则数组为空。 $("#formid :password").fieldValue();
resetForm 将表单恢复到初始状态。 $("#formid").resetForm();
clearForm 清除表单元素。该方法将所有的text、password、textarea置空,清除select元素中的选定,以及所有radio按钮和checkbox按钮重置为非选定状态。 $("#formid").clearForm();
clearFields 清除字段元素。只有部分表单元素需要清除时方便使用。 $("#formid .specialFields").clearFields();

Options对象

ajaxForm和ajaxSubmit都支持众多的选项参数,这些选项参数可以使用一个Options对象来提供。

target 指明页面中由服务器响应进行更新的元素。元素的值可能被指定为一个jQuery选择器字符串、一个jquery对象、一个DOM元素。 默认值:null
url 指定提交表单数据的URL。 默认值:表单的action属性值
type 指定提交表单数据的方法(method):“GET”或“POST”。 默认值:GET
beforeSubmit 表单提交前被调用的回调函数。如果回调函数返回false表单将不被提交。回调函数带三个调用参数:数组形式的表单数据,jQuery表单对象,以及传入ajaxForm/ajaxSubmit中的Options对象。 默认值:null
success 表单成功提交后调用的回调函数。然后dataType选项值决定传回responseText还是responseXML的值。 默认值:null
dataType 返回的数据类型:null、"xml"、"script"、"json"其中之一。 默认值:null
resetForm 表示如果表单提交成功是否进行重置。 默认值:null
clearForm 表示如果表单提交成功是否清除表单数据。 默认值:null
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);
}