jQuery off()メソッド
定義と使い方
off() メソッドは通常、on()メソッドで追加されたイベントハンドラーを削除するために使用されます。
jQuery バージョン 1.7 以降、off() メソッドは unbind()、die() および undelegate() メソッドの新しい代替品です。このメソッドは API に多くの利便性をもたらし、jQuery コードベースを簡素化するため、このメソッドの使用を推奨します。
注意:指定したイベントハンドラーを削除するには、イベントハンドラーが追加されたときに、セレクター文字列が on() メソッドに渡された引数と一致している必要があります。
ヒント:1回だけ実行されるイベントを追加してから削除するには、one()メソッドを使用してください。
構文
$(selector).off(event,selector,function(eventObj),map)
| パラメータ | 説明 |
|---|---|
| event | 必須。選択された要素から削除する1つ以上のイベントまたは名前空間を指定します。 スペースで区切られた複数のイベント値。有効なイベントである必要があります。 |
| selector | オプション。イベントハンドラーを追加するときに最初に on() メソッドに渡されたセレクターを指定します。 |
| function(eventObj) | オプション。イベント発生時に実行される関数を指定します。 |
| map | イベントマップを指定します({event:function, event:function, ...})、要素に追加する1つ以上のイベントと、イベント発生時に実行される関数を含みます。 |
その他の例
unbind() から off() に変更
off() を使用して unbind() と同じ効果を得る方法。
undelegate() から off() に変更
off() を使用して undelegate() と同じ効果を得る方法。
die() から off() に変更
off() を使用して die() と同じ効果を得る方法。
on() で追加されたすべての click イベントハンドラーを削除する
on() メソッドで <p> 要素すべてに追加された click イベントハンドラーを削除する方法。
on() で追加された指定のイベント関数を削除する
on() メソッドで追加された指定の関数を削除する方法。
event オブジェクトを使用したイベントハンドラーを削除する
イベントが特定の回数トリガーされた後にイベントハンドラーを削除する方法。
その他の拡張機能
jQuery イベントメソッド