Jquery插件之ajaxForm

如今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