.die()


.die()傳回:jQuery已棄用版本:1.7,已移除版本:1.9

說明: 從元素中移除先前使用 .live() 附加的事件處理常式。

  • 已加入版本:1.4.1.die()

    • 此簽章不接受任何參數。
  • 已加入版本:1.3.die( eventType [, handler ] )

    • eventType
      類型:字串
      包含 JavaScript 事件類型(例如 clickkeydown)的字串。
    • handler
      類型:字串
      不再執行的函式。
  • 已加入版本:1.4.3.die( events )

    • events
      類型:PlainObject
      一個或多個事件類型(例如 clickkeydown)的純粹物件,以及不再執行的相應函數。

注意:此 API 已在 jQuery 1.9 中移除;請改用 on()

任何已附加 .live() 的處理常式都可以用 .die() 移除。此方法類似於呼叫沒有參數的 .off(),用於移除所有附加 .on() 的處理常式。進一步的詳細資訊,請參閱 .live().off() 的討論。

如果沒有參數使用,.die() 會從元素中移除先前使用 .live() 附加的所有事件處理常式。

自 jQuery 1.7 起,不建議使用 .die()(及其補充方法 .live())。改用 .off() 移除使用 .on() 繫結的事件處理常式。

注意: 為了讓 .die() 正確運作,用於它的選擇器必須與最初用於 .live() 的選擇器完全相符。

範例

若要解除繫結所有段落的所有即時事件,請撰寫

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

若要解除繫結所有段落的所有即時 click 事件,請撰寫

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 );