内容目录
select()
函数用于为每个匹配元素的select事件绑定处理函数。该函数也可用于触发select事件。此外,你还可以额外传递给事件处理函数一些数据。
select事件会在文本框中的文本内容被选中时触发。该事件仅适用于<input type="text">和<textarea>文本框。
此外,你可以为同一元素多次调用该函数,从而绑定多个事件处理函数。触发select事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。
要删除通过select()
绑定的事件,请使用unbind()函数。
该函数属于jQuery
对象(实例)。
语法
jQueryObject.select( [ [ data ,] handler ] )
如果指定了至少一个参数,则表示绑定select事件的处理函数;没有指定任何参数,则表示触发select事件。
参数
参数 | 描述 |
---|---|
data | 可选/任意类型触发事件时,需要通过event.data传递给事件处理函数的任意数据。 |
handler | 可选/Function类型指定的事件处理函数。 |
jQuery 1.4.3 新增支持:select()
支持data
参数。
参数handler
中的this
指向当前DOM元素。select()
还会为handler
传入一个参数:表示当前事件的Event对象。
如果函数handler
的返回值为false
,则表示阻止元素的默认事件行为,并停止事件在DOM树中冒泡。例如,<a>链接的click事件的处理函数返回false
,可以阻止链接的默认URL跳转行为。<form>表单的submit事件的处理函数返回false
,可以阻止表单默认的表单提交行为。
返回值
select()
函数的返回值为jQuery类型,返回当前jQuery对象本身。
示例&说明
请参考下面这段初始HTML代码:
<input id="t1" name="name" type="text" />
<input id="t2" name="age" type="text" />
<div id="msg"></div>
现在,我们为所有text元素的select事件绑定处理函数(可以绑定多个,触发时按照绑定顺序依次执行):
var $texts = $(":text");
//为所有text元素的select事件绑定处理函数
$texts.select( function(event){
$(this).css("border", "1px solid blue");
} );
// 为所有text元素的select事件绑定处理函数
$texts.select( function(event){
$(this).css("border-radius", "3px");
} );
// 触发所有text元素的select事件
// $texts.select( ); // 调用不带任何参数的select()函数,会触发每个匹配元素的select事件
运行代码(以下代码请自行复制到演示页面运行)
我们还可以为事件处理函数传递一些附加的数据。此外,通过jQuery为事件处理函数传入的参数Event对象,我们可以获取当前事件的相关信息(比如事件类型、触发事件的DOM元素、附加数据等):
var user = { name: 'CodePlayer', age: 18 };
// 为所有text元素的select事件绑定处理函数
$(":text").select( user, function(event){
$("#msg").html( event.data.name + ",你选择了[" + this.name + "]中的一些文本内容!" ).show().fadeOut( 2000 );
} );
0 条评论
撰写评论