on()函數(shù)用于為指定元素的一個或多個事件綁定事件處理函數(shù)。
此外,你還可以額外傳遞給事件處理函數(shù)一些所需的數(shù)據(jù)。
從jQuery 1.7開始,on()函數(shù)提供了綁定事件處理程序所需的所有功能,用于統(tǒng)一取代以前的bind()、 delegate()、 live()等事件函數(shù)。
即使是執(zhí)行on()函數(shù)之后新添加的元素,只要它符合條件,綁定的事件處理函數(shù)也對其有效。
此外,該函數(shù)可以為同一元素、同一事件類型綁定多個事件處理函數(shù)。觸發(fā)事件時,jQuery會按照綁定的先后順序依次執(zhí)行綁定的事件處理函數(shù)。
要刪除通過on()綁定的事件,請使用off()函數(shù)。如果要附加一個事件,只執(zhí)行一次,然后刪除自己,請使用one()函數(shù)。
該函數(shù)屬于jQuery對象(實(shí)例)。
語法
jQuery1.7 新增該函數(shù)。其主要有以下兩種形式的用法:
用法一:
1jQueryObject.on( events [, selector ] [, data ], handler )
用法二:
1jQueryObject.on( eventsMap [, selector ] [, data ] )
參數(shù)
關(guān)于參數(shù)events中可選的命名空間,請參考最下面的示例代碼。
關(guān)于參數(shù)selector,你可以簡單地理解為:如果該參數(shù)等于null或被省略,則為當(dāng)前匹配元素綁定事件;否則就是為當(dāng)前匹配元素的后代元素中符合selector選擇器的元素綁定事件。
參數(shù)handler中的this指向當(dāng)前匹配元素的后代元素中觸發(fā)該事件的DOM元素。如果參數(shù)selector等于null或被省略,則this指向當(dāng)前匹配元素(也就是該元素)。
on()還會為handler傳入一個參數(shù):表示當(dāng)前事件的Event對象。
參數(shù)handler的返回值與DOM原生事件的處理函數(shù)返回值作用一致。例如"submit"(表單提交)事件的事件處理函數(shù)返回false,可以阻止表單的提交。
如果事件處理函數(shù)handler僅僅只為返回false值,可以直接將handler設(shè)為false。
返回值
on()函數(shù)的返回值為jQuery類型,返回當(dāng)前jQuery對象本身。
重要說明:
如果傳遞了selector參數(shù),那么on()函數(shù)并不是為當(dāng)前jQuery對象匹配的元素綁定事件處理函數(shù),而是為它們的后代元素中符合選擇器selector參數(shù)的元素綁定事件處理函數(shù)。on()函數(shù)并不是直接為這些后代元素挨個綁定事件,而是委托給當(dāng)前jQuery對象的匹配元素來處理。由于DOM 2級的事件流機(jī)制,當(dāng)后代元素selector觸發(fā)事件時,該事件會在事件冒泡中傳遞給其所有的祖輩元素,當(dāng)事件流傳遞到當(dāng)前匹配元素時,jQuery會判斷是哪個后代元素觸發(fā)了事件,如果該元素符合選擇器selector,jQuery就會捕獲該事件,從而執(zhí)行綁定的事件處理函數(shù)。
示例&說明
以點(diǎn)擊事件("click")為例,以下是jQuery中事件函數(shù)的常規(guī)用法(某些函數(shù)也存在其它形式的用法,此處暫不列出):
請參考下面這段初始HTML代碼:
我們?yōu)?lt;div>中的所有<p>元素綁定點(diǎn)擊事件:
如果要綁定所有的<p>元素,你可以編寫如下jQuery代碼:
此外,我們還可以同時綁定多個事件,并為事件處理函數(shù)傳遞一些附加的數(shù)據(jù),我們可以通過jQuery為事件處理函數(shù)傳入的參數(shù)event(Event事件對象)來進(jìn)行處理:
此外,即使符合條件的元素是on()函數(shù)執(zhí)行后新添加,綁定事件對其依然有效。同樣以初始HTML代碼為例,我們可以編寫如下jQuery代碼:
參數(shù)events還支持為事件類型附加額外的命名空間。當(dāng)為同一元素綁定多個相同類型的事件處理函數(shù)時。使用命名空間,可以在觸發(fā)事件、移除事件時限定觸發(fā)或移除的范圍。