ajaxForm() 和 ajaxSubmit() 的用法与区别

迈不过友情╰ 2022-04-12 04:47 375阅读 0赞

## 一、Query.form.js 介绍 ##

Query.form.js 是一个 form 插件，可以实现表单提交并在当前页面中处理返回值，即 html 中提交表单并实现不跳转页面处理返回值。

## 二、下载地址 ##

[http://malsup.github.io/jquery.form.js][http_malsup.github.io_jquery.form.js]

## 三、ajaxForm() 和 ajaxSubmit() 的用法 ##

### 1、引入 js 文件 ###

### 2、ajaxForm() 使用 ###

$(function () { 
            $('#myForm').ajaxForm({ 
                beforeSubmit: validate,
                success: function(data) { 
                   //返回数据处理
                    alert(data);
                }
            });
        });
    
    function validate() { 
           ...
    }

### 3、ajaxSubmit() 使用 ###

$(function () { 
            $('#myForm').submit(function () { 
                $('#myForm').ajaxSubmit({ 
                    beforeSubmit: validate,
                    success: function(data) { 
                        //返回数据处理
                        alert(data);
                    }
                });
                return false;         //阻止表单默认提交
            });
        });
    
    
    function validate() { 
           ...
    }

### 4、前端 html 代码 ###

### 5、参数介绍 ###

ajaxForm() 和 ajaxSubmit() 的可选参数项对象：  
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 域要上传文件时。  
缺省值： false

## 四、ajaxForm() 和 ajaxSubmit() 的区别 ##

这两种方法主要的却别是 ajaxForm() 不能主动提交 form，函数只是为提交表单做准备需要以 submit 来触发提交；而 ajaxSubmit() 会主动提交表单，同时可以在点击其他按钮时也可以触发提交，不一定是submit按钮。

$("form").ajaxForm();

等价于

$("form").submit(function(){ 
                $(this).ajaxSubmit();
                return false;        //ajaxSubmit 会自动提交表单，想要阻止自动提交，必须return false；
            })

1: [html中提交表单并实现不跳转页面处理返回值][html]  
2: [jQuery form插件的使用–ajaxForm()和ajaxSubmit()的可选参数项对象][jQuery form_ajaxForm_ajaxSubmit]  
3: [ajaxForm和ajaxSubmit的用法与区别][ajaxForm_ajaxSubmit]

[http_malsup.github.io_jquery.form.js]: http://malsup.github.io/jquery.form.js
[html]: https://blog.csdn.net/smilefyx/article/details/49332433
[jQuery form_ajaxForm_ajaxSubmit]: https://blog.csdn.net/qq_38602656/article/details/78668924
[ajaxForm_ajaxSubmit]: https://www.cnblogs.com/fire-dragon/p/6708718.html