die(eventType, [handler])


version 1.3 以降

解説

live(eventType, [eventData], handler) でバインドしたイベントハンドラを削除します。

引数の形が2種類あります。

type1

引数なしで呼び出した場合は、live(eventType, [eventData], handler) でバインドした全てのイベントハンドラが削除されます。(version 1.4 から)

戻り値

  • jQuery: jQueryオブジェクト
type2

指定した eventType に live(eventType, [eventData], handler) でバインドしたイベントハンドラが削除されます。
handler を指定した場合は、そのイベントハンドラのみ削除されます。

引数

  • eventTypeオプション
    String: バインドされているイベントを表す文字列。
  • [handler]オプション
    Function: バインドされているイベントハンドラ関数。

戻り値

  • jQuery: jQueryオブジェクト

関連


例1:「live」ボタンをクリックすると、同じセレクタでマッチする要素を追加するイベントハンドラをバインドします。 後から生成された要素もセレクタにマッチするため、同じイベントハンドラがバインドされます。
(「段落」をクリックすると、要素を追加します。)

「die」ボタンをクリックすると、後から生成された要素も含め、live メソッドで登録されたイベントハンドラをアンバインドします。

var liveClickHandler = function() {
    $(this).after("<p class='live'>段落</p>");
}

$("#live").click(function(){
    $("p.live")
        .live("click", liveClickHandler)
        .css("backgroundColor", "#dcffdc");
});

$("#die").click(function(){
    $("p.live")
        .die("click", liveClickHandler)
        .css("backgroundColor", "#fcfcfc");
});


例1


段落