submit()函数用于为每个匹配元素的submit事件绑定处理函数。该函数也可用于触发submit事件。此外,你还可以额外传递给事件处理函数一些数据。
submit事件会在表单被提交时触发。该事件仅适用于ff9c23ada1bcecdd1a0fb5d5a0f18437元素。
此外,你可以为同一元素多次调用该函数,从而绑定多个事件处理函数。触发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树中冒泡。例如,3499910bf9dac5ae3c52d5ede7383485链接的click事件的处理函数返回false,可以阻止链接的默认url跳转行为。ff9c23ada1bcecdd1a0fb5d5a0f18437表单的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() 函数详解的详细内容。