.die()

所属分类：事件 > 绑定事件处理器 | 弃用 > 1.7 版本弃用的 API | 已删除的函数 英文文档：.die()

.die()返回: jQueryversion deprecated: 1.7, removed: 1.9

描述: 从元素中删除先前用.live()绑定的所有事件。

  • 添加的版本: 1.4.1.die()

    • 这个方法不接受任何参数。

  • 添加的版本: 1.3.die( eventType [, handler ] )

    • eventType
      类型: String
      一个包含一个JavaScript事件类型的字符串，比如click 或keydown。
    • handler
      类型: String
      将来不再执行的函数。

  • 添加的版本: 1.4.3.die( events )

    • events
      类型: PlainObject
      包含一个或多个事件类型的一个普通对象，比如 click 或者 keydown并且其相应的函数将来不再被执行。

任何通过.live()绑定的处理程序都可以使用.die()删除。这个方法类似于调用不带参数的.unbind()，这是用来删除先前用.bind() 绑定的所有事件。见.live()和.unbind()讨论的更多详情。

如果不带参数使用，.die()将从元素中删除先前用.live()绑定的所有事件。

从jQuery 1.7开始, .die()（ 和互补的方法.live() ）是不建议使用的。  相反，推荐使用.off()移除通过.on()绑定的事件处理程序。

注意: 为了.die()能正常工作，选择器使用它必须完全匹配选择器最初使用.live()。

例子:

Example: 解除所有段落上绑定的 live 事件：

1
 
$("p").die()

Example: 解除所有段落上通过 live 事件绑定的 click 事件：

1
 
$("p").die( "click" )

Example: 解除之前绑定的事件处理，将该事件处理作为第二个参数：

1
2
3
4
5
6
7
 
var foo = function () {
  // code to handle some kind of event
};
 
$("p").live("click", foo); // ... now foo will be called when paragraphs are clicked ...
 
$("p").die("click", foo); // ... foo will no longer be called.