jQuery unbind()メソッド
定義と使い方
unbind() メソッドは、選択された要素のイベントハンドラを削除します。
このメソッドは、すべての、または選択されたイベントハンドラを削除したり、イベント発生時に指定された関数の実行を終了したりできます。
このメソッドは、event オブジェクトを使用してイベントハンドラのバインドを解除することもできます。また、イベントが一定回数トリガーされた後にイベントハンドラを削除するなど、自身の内部イベントのバインドを解除するためにも使用されます。
注意:パラメータが指定されていない場合、unbind() メソッドは指定された要素のすべてのイベントハンドラを削除します。
注意:unbind() メソッドは、jQuery によって追加された任意のイベントハンドラに適用されます。
jQuery バージョン 1.7 以降、on()とoff()メソッドは、要素にイベントハンドラを追加および削除するための推奨方法です。
構文
$(selector).unbind(event,function,eventObj)
| パラメータ | 説明 |
|---|---|
| event | 省略可能。要素から削除する1つ以上のイベントを指定します。 複数のイベント値はスペースで区切ります。 このパラメータのみが指定された場合、指定されたイベントにバインドされているすべての関数が削除されます。 |
| function | 省略可能。要素上の指定されたイベントのバインドを解除する関数名を指定します。 |
| eventObj | 省略可能。バインド解除に使用する event オブジェクトを指定します。この
eventObjパラメータはイベントバインド関数から取得されます。 |
その他の例
指定された関数のバインドを解除する
unbind() メソッドを使用して、要素上の指定されたイベントから特定の関数のバインドを解除する方法。
event オブジェクトを使用してイベントハンドラのバインドを解除する
削除する event オブジェクトを指定します。
その他の拡張
jQuery イベントメソッド