当前位置: 首页 > 中文手册 > jQuery.submit() 函数详解

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;
	}
} );
68 17
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。