on()函數(shù)用于為指定元素的一個(gè)或多個(gè)事件綁定事件處理函數(shù)局扶。
此外攒驰,你還可以額外傳遞給事件處理函數(shù)一些所需的數(shù)據(jù)项戴。
從jQuery 1.7開始宛裕,on()函數(shù)提供了綁定事件處理程序所需的所有功能穆碎,用于統(tǒng)一取代以前的bind()牙勘、 delegate()、 live()等事件函數(shù)所禀。
即使是執(zhí)行on()函數(shù)之后新添加的元素方面,只要它符合條件,綁定的事件處理函數(shù)也對其有效色徘。
此外恭金,該函數(shù)可以為同一元素、同一事件類型綁定多個(gè)事件處理函數(shù)褂策。觸發(fā)事件時(shí)横腿,jQuery會(huì)按照綁定的先后順序依次執(zhí)行綁定的事件處理函數(shù)颓屑。
要?jiǎng)h除通過on()綁定的事件,請使用off()函數(shù)耿焊。如果要附加一個(gè)事件揪惦,只執(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()還會(huì)為handler傳入一個(gè)參數(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ù)并不是直接為這些后代元素挨個(gè)綁定事件稍坯,而是委托給當(dāng)前jQuery對象的匹配元素來處理酬荞。由于DOM 2級的事件流機(jī)制,當(dāng)后代元素selector觸發(fā)事件時(shí)瞧哟,該事件會(huì)在事件冒泡中傳遞給其所有的祖輩元素袜蚕,當(dāng)事件流傳遞到當(dāng)前匹配元素時(shí),jQuery會(huì)判斷是哪個(gè)后代元素觸發(fā)了事件绢涡,如果該元素符合選擇器selector牲剃,jQuery就會(huì)捕獲該事件,從而執(zhí)行綁定的事件處理函數(shù)雄可。
示例&說明
以點(diǎn)擊事件("click")為例凿傅,以下是jQuery中事件函數(shù)的常規(guī)用法(某些函數(shù)也存在其它形式的用法缠犀,此處暫不列出):
請參考下面這段初始HTML代碼:
我們?yōu)?lt;div>中的所有<p>元素綁定點(diǎn)擊事件:
如果要綁定所有的<p>元素,你可以編寫如下jQuery代碼:
此外聪舒,我們還可以同時(shí)綁定多個(gè)事件辨液,并為事件處理函數(shù)傳遞一些附加的數(shù)據(jù),我們可以通過jQuery為事件處理函數(shù)傳入的參數(shù)event(Event事件對象)來進(jìn)行處理:
此外箱残,即使符合條件的元素是on()函數(shù)執(zhí)行后新添加滔迈,綁定事件對其依然有效。同樣以初始HTML代碼為例被辑,我們可以編寫如下jQuery代碼:
參數(shù)events還支持為事件類型附加額外的命名空間燎悍。當(dāng)為同一元素綁定多個(gè)相同類型的事件處理函數(shù)時(shí)。使用命名空間盼理,可以在觸發(fā)事件谈山、移除事件時(shí)限定觸發(fā)或移除的范圍。