首頁 > web前端 > js教程 > 主體

jQuery on()選擇器函數

巴扎黑
發布: 2017-06-25 10:44:30
原創
1077 人瀏覽過

on()函數用於為指定元素的一個或多個事件綁定事件處理函數

此外,你還可以額外傳遞給事件處理函數一些所需的資料。

從jQuery 1.7開始,on()函數提供了綁定事件處理程序所需的所有功能,用於統一取代先前的bind()、 delegate()、live( )等事件函數。

即使是執行on()函數之後新加入的元素,只要它符合條件,綁定的事件處理函數也對其有效。

此外,函數可以為相同元素、相同事件類型綁定多個事件處理函數。觸發事件時,jQuery會依照綁定的先後順序依序執行綁定的事件處理函數。

要刪除透過on()綁定的事件,請使用off()函數。如果要附加一個事件,只執行一次,然後刪除自己,請使用one()函數。

該函數屬於jQuery物件(實例)。

語法

jQuery 1.7 新增此函數。其主要有以下兩種形式的用法:

用法一


1 jQueryObject.on( events [, selector ] [, data ], handler )
登入後複製

#用法二


1 jQueryObject.on( eventsMap [, selector ] [, data ] )
登入後複製

參數

##描述#eventseventsMap#Object類型一個)。 selector#可選/String類型一個jQuery選擇器,用於指定哪些後代元素可以觸發綁定的事件。如果該參數為null或被省略,則表示當前元素本身綁定事件(實際觸發者也可能是後代元素,只要事件流能到達目前元素即可)。 #可選/任意型別觸發事件時,需要透過event.data傳遞給事件處理函數的任意數據。
#參數
String類型一個或多個用空格分隔的事件類型和可選的命名空間,例如"click" 、"focus click"、"keydown.myPlugin"。
Object物件,其每個屬性對應事件類型和可選的命名空間(參數events),屬性值對應綁定的事件處理函數(參數handler
data
###############handler#############Function類型指定的事件處理函數。 ################

关于参数events中可选的命名空间,请参考最下面的示例代码。

关于参数selector,你可以简单地理解为:如果该参数等于null或被省略,则为当前匹配元素绑定事件;否则就是为当前匹配元素的后代元素中符合selector选择器的元素绑定事件。

参数handler中的this指向当前匹配元素的后代元素中触发该事件的DOM元素。如果参数selector等于null或被省略,则this指向当前匹配元素(也就是该元素)。

on()还会为handler传入一个参数:表示当前事件的Event对象。

参数handler的返回值与DOM原生事件的处理函数返回值作用一致。例如"submit"(表单提交)事件的事件处理函数返回false,可以阻止表单的提交。

如果事件处理函数handler仅仅只为返回false值,可以直接将handler设为false

返回值

on()函数的返回值jQuery类型,返回当前jQuery对象本身。

重要说明

如果传递了selector参数,那么on()函数并不是为当前jQuery对象匹配的元素绑定事件处理函数,而是为它们的后代元素中符合选择器selector参数的元素绑定事件处理函数。on()函数并不是直接为这些后代元素挨个绑定事件,而是委托给当前jQuery对象的匹配元素来处理。由于DOM 2级的事件流机制,当后代元素selector触发事件时,该事件会在事件冒泡中传递给其所有的祖辈元素,当事件流传递到当前匹配元素时,jQuery会判断是哪个后代元素触发了事件,如果该元素符合选择器selector,jQuery就会捕获该事件,从而执行绑定的事件处理函数。

 

示例&说明

 

以点击事件("click")为例,以下是jQuery中事件函数的常规用法(某些函数也存在其它形式的用法,此处暂不列出):


 1 // 这里的选择器selector用于指定可以触发事件的元素 2 // 这里的选择器ancestor应是selector的祖辈元素,selector触发的事件可以被其祖辈元素在事件流中捕获,从而以"代理"的形式触发事件。 3  4 // jQuery 1.0+ (1.4.3+支持参数data) 5 $("selector").click( [ data ,] handler ); 6  7 // jQuery 1.0+ (1.4.3+支持参数data) 8 $("selector").bind( "click" [, data ], handler ); 9 10 // jQuery 1.3+ (1.4+支持参数data)11 $("selector").live( "click" [, data ], handler );12 13 // jQuery 1.4.2+14 $("ancestor").delegate( "selector", "click" [, data ], handler );15 16 // jQuery 1.7+17 $("ancestor").on( "click", "selector" [, data ], handler );
登入後複製

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


1 <p id="n1">2     <p id="n2"><span>CodePlayer</span></p>3     <p id="n3"><span>专注于编程开发技术分享</span></p>4     <em id="n4">http://www.365mini.com</em>5 </p>6 <p id="n5">Google</p>
登入後複製

我们为

中的所有

元素绑定点击事件:


1 // 为p中的所有p元素绑定click事件处理程序2 // 只有n2、n3可以触发该事件3 $("p").on("click", "p", function(){4     // 这里的this指向触发点击事件的p元素(Element)5     alert( $(this).text() );6 });
登入後複製

如果要绑定所有的

元素,你可以编写如下jQuery代码:


1 //为所有p元素绑定click事件处理程序(注意:这里省略了selector参数)2 //n2、n3、n5均可触发该事件3 $("p").on("click", function(event){4 // 这里的this指向触发点击事件的p元素(Element)5     alert( $(this).text() );6 });
登入後複製

此外,我们还可以同时绑定多个事件,并为事件处理函数传递一些附加的数据,我们可以通过jQuery为事件处理函数传入的参数event(Event事件对象)来进行处理:


 1 var data = { id: 5, name: "张三" };
 //为n5绑定mouseenter mouseleave两个事件,并为其传入附加数据data 
 // 附加数据可以是任意类型
 $("body").on("mouseenter mouseleave", "#n5", data, function(event){ 
     var $me = $(this); 7     var options = event.data; // 这就是传入的附加数据 8     if( event.type == "mouseenter"){ 9         $me.html( "你好," + options.name + "!");      
     }else if(event.type == "mouseleave" ){     
        $me.html( "再见!");       
     }           
});
登入後複製

此外,即使符合条件的元素是on()函数执行后新添加,绑定事件对其依然有效。同样以初始HTML代码为例,我们可以编写如下jQuery代码:


1 // 为p中的所有p元素绑定click事件处理程序2 // 只有n2、n3可以触发该事件3 $("p").on("click", "p", function(event){4     alert( $(this).text() );5 });6 7 // 后添加的n6也可以触发上述click事件,因为它也是p中的p元素8 $("#n1").append('<p id="n6">上述绑定的click事件对此元素也生效!</p>');
登入後複製

参数events还支持为事件类型附加额外的命名空间。当为同一元素绑定多个相同类型的事件处理函数时。使用命名空间,可以在触发事件、移除事件时限定触发或移除的范围。


 1 function clickHandler(event){ 2     alert( "触发时的命名空间:[" + event.namespace + "]"); 3 } 4  5 var $p = $("p"); 6  7 // A:为所有p元素绑定click事件,定义在foo和bar两个命名空间下 8 $p.on( "click.foo.bar", clickHandler ); 9 10 // B:为所有p元素绑定click事件,定义在test命名空间下11 $p.on( "click.test", clickHandler );12 13 var $n2 = $("#n2");14 15 // 触发所有click事件16 $n2.trigger("click"); // 触发A和B (event.namespace = "")17 18 // 触发定义在foo命名空间下的click事件19 $n2.trigger("click.foo"); // 触发A (event.namespace = "foo")20 // 触发定义在bar命名空间下的click事件21 $n2.trigger("click.bar"); // 触发A (event.namespace = "bar")22 // 触发同时定义在foo和bar两个命名空间下的click事件23 $n2.trigger("click.foo.bar"); // 触发A (event.namespace = "bar.foo")24 25 // 触发定义在test命名空间下的click事件26 $n2.trigger("click.test"); // 触发B (event.namespace = "test")27 28 // 移除所有p元素定义在foo命名空间下的click事件处理函数29 $p.off( "click.foo" ); // 移除A30 31 on()函数的参数eventsMap是一个对象,可以"属性-值"的方式指定多个"事件类型-处理函数"。对应的示例代码如下:32 33 var data = { id: 5, name: "张三" };34 35 var events = {36     "mouseenter": function(event){37         $(this).html( "你好," + event.data.name + "!");       
38     },39     40     "mouseleave": function(event){41         $(this).html( "再见!");42     }       
43 };44 45 //为n5绑定mouseenter mouseleave两个事件,并为其传入附加数据data46 $("body").on(events, "#n5", data);
登入後複製

 

以上是jQuery on()選擇器函數的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板
關於我們 免責聲明 Sitemap
PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!