.die()

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

描述:从元素上删除先前利用.live()附加上去的事件处理函数。

  • 增补版本:1.4.1.die()

    • 此签名没有任何参数。
  • 增补版本:1.3.die( eventType [, handler ] )

    • eventType
      类型:String
      一个字符串,包含了一个JavaScript事件类型,譬如clickkeydown
    • handler
      类型:String
      不再被执行的函数。
  • 增补版本:1.4.3.die( events )

    • events
      类型:PlainObject
      由一个或多保事件类型(譬如clickkeydown)以及它们对应的不再被执行的函数构成的扁平对象

任何用.live()附加的处理函数都可以用.die()来删除。此方法类似于不带参数地调用.off(),它可以用来删除所有用.on()附加的处理函数。 请参阅关于.live().off()的讨论以进一步了解细节。

如果不带参数地使用,.die()会从元素上删除掉所有的先前用.live()方法附加的事件处理函数。

自从jQuery 1.7以来.die()的使用(以及与此相辅相成的方法.live())不再建议使用了。请用.off()方法删除用.on()绑定的事件处理函数。

请注意:为了正确地执行.die(),与它配合使用的选择器必须精确匹配最初与.live()配合使用的选择器。

示例:

若要从所有段落上解绑所有活动事件,请这么写:

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

若要从所有段落上解绑所有活动的点击事件,请这么写:

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

若要只解绑一个先前绑定的处理函数,传递函数名称作为第二个参数:

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