jQuery unbind() メソッド

❮ jQuery Event メソッド

全 <p> 要素の全てのイベントハンドラを削除する:

$("button").click(function(){
    $("p").unbind();
});
Try it Yourself »

定義と用法

unbind() メソッドは、選択した要素からイベントハンドラを削除します。

このメソッドは、すべてのイベントハンドラ、または選択したイベントハンドラを削除するか、 イベントが発生したときに実行する関数を停止することができます。

このメソッドは、イベントオブジェクトを使用してイベントハンドラを unbind することができます。 これは、(イベントを一定回数トリガした後に、イベントハンドラを削除するような) それ自身内からイベントを unbind するために使用します。

注: パラメータを指定しない場合、unbind() メソッドは、 指定した要素からすべてのイベントハンドラを削除します。

注:unbind() メソッドは、jQueryを使用して接続された任意のイベントハンドラで動作します。

jQuery version 1.7 時点では、要素へのイベントハンドラの接続と削除には、 on()off() メソッドが推奨されています。


構文

$(selector).unbind(event,function,eventObj)

パラメータ 説明
event 任意。要素から削除する 1 つ以上のイベントを指定する。.
複数のイベントはカンマで区切る。
これが指定した唯一のパラメータである場合、指定したイベントにバインドされている全ての関数が削除される
function 任意。要素に指定したイベントから unbind する関数の名前を指定する
eventObj 任意。削除に使用するためイベント・オブジェクトを指定する。 eventObj パラメータは、function にバインドしたイベント

Try it Yourself - 例

指定の関数を解除(unbind)する
要素に指定したイベントから、指定の関数を解除するために unbind() メソッドを使用する方法。.

イベントオブジェクトを使用したイベントハンドラの解除
削除するイベントオブジェクトを指定します。


❮ jQuery Event メソッド