dblclick()函数用于为每个匹配元素的dblclick事件绑定处理函数。该函数也可用于触发dblclick事件。
dblclick事件就是鼠标左键双击事件。此外,你还可以额外传递给事件处理函数一些数据。
此外,你可以为同一元素多次调用该函数,从而绑定多个事件处理函数。触发dblclick事件时,jquery会按照绑定的先后顺序依次执行绑定的事件处理函数。
要删除通过dblclick()绑定的事件,请使用unbind()函数。
该函数属于jquery对象(实例)。
语法
jqueryobject.dblclick( [ [ data ,] handler ] )
如果指定了至少一个参数,则表示绑定dblclick事件的处理函数;没有指定任何参数,则表示触发dblclick事件。
参数
jquery 1.4.3 新增支持:dblclick()支持data参数。
参数handler中的this指向当前dom元素。dblclick()还会为handler传入一个参数:表示当前事件的event对象。
如果函数handler的返回值为false,则表示阻止元素的默认事件行为,并停止事件在dom树中冒泡。例如,<a>链接的click事件的处理函数返回false,可以阻止链接的默认url跳转行为。<form>表单的submit事件的处理函数返回false,可以阻止表单默认的表单提交行为。
返回值
dblclick()函数的返回值为jquery类型,返回当前jquery对象本身。
示例&说明
请参考下面这段初始html代码:
<input id="btn1" type="button" value="双击1" />
<input id="btn2" type="button" value="双击2" />
现在,我们为所有button元素的dblclick事件绑定处理函数(可以绑定多个,触发时按照绑定顺序依次执行):
// 为所有button元素的dblclick事件绑定处理函数
$(":button").dblclick( function(event){
alert( this.value + "-1" );
} );
// 为所有button元素的dblclick事件绑定处理函数
$(":button").dblclick( function(event){
alert( this.value + "-2" );
} );
// 触发所有button元素的dblclick事件
$(":button").dblclick( ); // 调用不带任何参数的dblclick()函数,会触发每个匹配元素的dblclick事件
我们还可以为事件处理函数传递一些附加的数据。此外,通过jquery为事件处理函数传入的参数event对象,我们可以获取当前事件的相关信息(比如事件类型、触发事件的dom元素、附加数据等):
var user = { name: 'codeplayer', age: 18 };
// 为所有button元素的dblclick事件绑定处理函数
$(":button").dblclick( user, function(event){
alert( event.data.name ); // codeplayer
} );
以上就是jquery中.dblclick()函数的使用详解的详细内容。