Jquery插件之ajaxForm

Posted 2020-06-30

如今ajax满天飞，作为重点的form自然也受到照顾。

其实，我们在平常使用Jquery异步提交表单，一般是在submit()中，使用$.ajax进行。比如：

    $(function(){
        $(‘#myForm‘).submit(function(){
            $.ajax({
                url:"/WebTest/test/testJson.do",
                data:$(‘#myForm‘).serialize(),
                dataType:"json",
                error:function(data){
                    alert(data);
                },
                success:function(data){
                    alert(data);
                }
            });
        });        
    }) 

这样的方式掩盖了form的功能，使它成为了变相的ajax。下面来看看符合form思想的ajaxForm。

 

ajaxForm:

先下载：http://files.cnblogs.com/china-li/jquery.form.js

两个主要的API：ajaxForm() ajaxSubmit()。

ajaxForm()配置完之后，并不是马上的提交，而是要等submit()事件，它只是一个准备。一般用法：

$(document).ready(function() { 
    var options = { 
        target:        ‘#output1‘,   // target element(s) to be updated with server response 
        beforeSubmit:  showRequest,  // pre-submit callback 
        success:       showResponse  // post-submit callback 
 
        // other available options: 
        //url:       url         // override for form‘s ‘action‘ attribute 
        //type:      type        // ‘get‘ or ‘post‘, override for form‘s ‘method‘ attribute 
        //dataType:  null        // ‘xml‘, ‘script‘, or ‘json‘ (expected server response type) 
        //clearForm: true        // clear all form fields after successful submit 
        //resetForm: true        // reset the form after successful submit 
 
        // $.ajax options can be used here too, for example: 
        //timeout:   3000 
    }; 
 
    // bind form using ‘ajaxForm‘ 
    $(‘#myForm1‘).ajaxForm(options).submit(function(){return false;}); 
});

这个是官方的例子，不过他没有最后的提交。提交中返回false，阻止它的默认提交动作，而是用ajax交互。

其中options的属性，重要的解释一下：

target        返回的结果将放到这个target下
url           如果定义了，将覆盖原form的action
type          get和post两种方式
dataType      返回的数据类型，可选：json、xml、script
clearForm     true，表示成功提交后清除所有表单字段值
resetForm     true，表示成功提交后重置所有字段
iframe        如果设置，表示将使用iframe方式提交表单
beforeSerialize    数据序列化前：function($form,options){}
beforeSubmit  提交前：function(arr,$from,options){}
success       提交成功后：function(data,statusText){}
error         错误：function(data){alert(data.message);}   

 ajaxSubmit示例：

$(document).ready(function() { 
    var options = { 
        target:        ‘#output2‘,   // target element(s) to be updated with server response 
        beforeSubmit:  showRequest,  // pre-submit callback 
        success:       showResponse  // post-submit callback 
 
        // other available options: 
        //url:       url         // override for form‘s ‘action‘ attribute 
        //type:      type        // ‘get‘ or ‘post‘, override for form‘s ‘method‘ attribute 
        //dataType:  null        // ‘xml‘, ‘script‘, or ‘json‘ (expected server response type) 
        //clearForm: true        // clear all form fields after successful submit 
        //resetForm: true        // reset the form after successful submit 
 
        // $.ajax options can be used here too, for example: 
        //timeout:   3000 
    }; 
 
    // bind to the form‘s submit event 
    $(‘#myForm2‘).submit(function() { 
        // inside event callbacks ‘this‘ is the DOM element so we first 
        // wrap it in a jQuery object and then invoke ajaxSubmit 
        $(this).ajaxSubmit(options); 
 
        // !!! Important !!! 
        // always return false to prevent standard browser submit and page navigation 
        return false; 
    }); 
}); 

其中参数配置大同小异。只是ajaxSubmit()可以任何时刻都能提交！

 

其他的API： 

$(‘#myFormId‘).clearForm();
$(‘#myFormId .specialFields‘).clearFields();
$(‘#myFormId‘).resetForm();
var value = $(‘#myFormId :password‘).fieldValue();
var queryString = $(‘#myFormId .specialFields‘).fieldSerialize();

 

另外，官方有一个进度条的demo，可以参考一下：http://www.malsup.com/jquery/form/progress.html