jQuery off() 方法

jQuery 事件方法 jQuery 事件方法

實例

移除所有 <p> 元素上的 click 事件:

$("button").click(function(){ $("p").off("click"); });


定義和用法

off() 方法通常用於移除通過 on() 方法添加的事件處理程式。

自 jQuery 版本 1.7 起,off() 方法是 unbind()、die() 和 undelegate() 方法的新的替代品。該方法給 API 帶來很多便利,我們推薦使用該方法,它簡化了 jQuery 代碼庫。

注意:如需移除指定的事件處理程式,當事件處理程式被添加時,選擇器字串必須匹配 on() 方法傳遞的參數。

提示:如需添加只運行一次的事件然後移除,請使用 one() 方法。


語法

$(selector).off(event,selector,function(eventObj),map)

參數 描述
event 必需。規定要從被選元素移除的一個或多個事件或命名空間。

由空格分隔多個事件值。必須是有效的事件。
selector 可選。規定添加事件處理程式時最初傳遞給 on() 方法的選擇器。
function(eventObj) 可選。規定當事件發生時運行的函數。
map 規定事件映射 ({event:function, event:function, ...}),包含要添加到元素的一個或多個事件,以及當事件發生時運行的函數。


實例

更多實例

從 unbind() 改為 off()
如何使用 off() 來達到與 unbind() 相同的效果。

從 undelegate() 改為 off()
如何使用 off() 來達到與 undelegate() 相同的效果。

從 die() 改為 off()
如何使用 off() 來達到與 die() 相同的效果。

移除所有通過 on() 添加的 click 事件處理程式
如何移除所有通過 on() 方法添加到所有 <p> 元素上的 click 事件處理程式。

移除一個通過 on() 添加的指定的事件函數
如何移除一個通過 on() 方法添加的指定的函數。

移除使用 event 對象的事件處理程式
如何在事件觸發某一確定次數後移除事件處理程式。


jQuery 事件方法 jQuery 事件方法