jQuery.submit() 函数详解

submit()函数用于为每个匹配元素的submit事件绑定处理函数。该函数也可用于触发submit事件。此外，你还可以额外传递给事件处理函数一些数据。

submit事件会在表单被提交时触发。该事件仅适用于<form>元素。

此外，你可以为同一元素多次调用该函数，从而绑定多个事件处理函数。触发submit事件时，jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。

要删除通过submit()绑定的事件，请使用unbind()函数。

该函数属于jQuery对象(实例)。

语法

jQueryObject.submit( [ [ data ,] handler ] )

如果指定了至少一个参数，则表示绑定submit事件的处理函数；没有指定任何参数，则表示触发submit事件。

参数

参数 描述

data 可选/任意类型触发事件时，需要通过event.data传递给事件处理函数的任意数据。

handler 可选/Function类型指定的事件处理函数。

jQuery 1.4.3 新增支持：submit()支持data参数。

参数handler中的this指向当前DOM元素。submit()还会为handler传入一个参数：表示当前事件的Event对象。

如果函数handler的返回值为false，则表示阻止元素的默认事件行为，并停止事件在DOM树中冒泡。例如，<a>链接的click事件的处理函数返回false，可以阻止链接的默认URL跳转行为。<form>表单的submit事件的处理函数返回false，可以阻止表单默认的表单提交行为。

返回值

submit()函数的返回值为jQuery类型，返回当前jQuery对象本身。

示例&说明

请参考下面这段初始HTML代码：

<form id="myForm" action="http://www.365mini.com" method="post">
    <input id="name" name="name" type="text" value="CodePlayer" /><br>
    <input id="age" name="age" type="text" value="20" /><br>
    <input type="submit" value="提交" />
</form>
<div id="msg"></div>

现在，我们为<form>元素的submit事件绑定处理函数(可以绑定多个，触发时按照绑定顺序依次执行)：

$("form").submit( function(event){
    if( !$("#name").val() ){
        alert("姓名不能为空!");
        return false; // 返回值为false，将阻止表单提交
    }else if( !$("#age").val() ){
        alert("年龄不能为空!");
        return false; // 返回值为false，将阻止表单提交
    }
} );
// 触发form元素的submit事件
// $("form").submit( );

我们还可以为事件处理函数传递一些附加的数据。此外，通过jQuery为事件处理函数传入的参数Event对象，我们可以获取当前事件的相关信息(比如事件类型、触发事件的DOM元素、附加数据等)：

var map = { name: "姓名", age: "年龄" };
$("form").submit( map, function(event){
    var labelMap = event.data;
    var label = '';
    // 循环验证所有text元素是否为空
    $(this).find(":text").each(function(){
        if( !this.value ){
            label = labelMap[this.name];
            return false;
        }       
    });    
    if( label ){
        alert( label + "不能为空!" );
        return false;
    }
} );

以上就是jQuery.submit() 函数详解的详细内容，更多请关注其它相关文章！