jQuery off() 方法
定义和用法
off() 方法最常用于移除使用 on() 方法附加的事件处理程序。
从 jQuery 1.7 版本开始,off() 方法是 unbind()、die() 和 undelegate() 方法的新替代方法。此方法为 API 带来了很多一致性,我们建议您使用此方法,因为它简化了 jQuery 代码库。
注意:要移除特定的事件处理程序,选择器字符串必须与附加事件处理程序时传递给 on() 方法的字符串匹配。
提示:要附加仅运行一次然后自动移除自身的事件,请使用 one() 方法。
语法
$(选择器).off(事件,选择器,函数(eventObj),映射)
参数 | 描述 |
---|---|
事件 | 必需。指定要从选定元素中移除的一个或多个事件或命名空间。 多个事件值用空格分隔。必须是有效的事件 |
选择器 | 可选。一个选择器,它应该与最初在附加事件处理程序时传递给 on() 方法的选择器匹配。 |
函数(eventObj) | 可选。指定事件发生时要运行的函数。 |
映射 | 指定一个事件映射 ({事件:函数, 事件:函数, ...}),其中包含一个或多个要附加到元素的事件,以及事件发生时要运行的函数。 |
亲自试一试 - 示例
移除使用 on() 添加的所有点击事件处理程序
如何移除使用 on() 方法添加的所有 <p> 元素的所有点击事件处理程序。
移除使用 on() 添加的一个特定事件函数
如何移除使用 on() 方法添加的特定函数。
使用事件对象移除事件处理程序
如何在事件触发特定次数后移除事件处理程序。