jQuery on()メソッド
例
<p> 要素に click イベントハンドラを追加します:
試してみる »
定義と用法
on() メソッドは、選択された要素および子要素に1つ以上のイベントハンドラを追加します。
jQuery バージョン 1.7 以降、on() メソッドは bind()、live()、delegate() メソッドの新しい代替品です。このメソッドは API に多くの利便性をもたらすため、このメソッドの使用を推奨します。jQuery コードベースを簡素化します。
注意:on() メソッドを使用して追加されたイベントハンドラは、現在および将来の要素(スクリプトによって作成された新しい要素など)に適用されます。
ヒント:イベントハンドラを削除する場合は、off()メソッドを使用してください。
ヒント:1回だけ実行してから削除するイベントを追加する場合は、one()メソッドを使用してください。
構文
| パラメータ | 説明 |
|---|---|
| event | 必須。選択された要素に追加する1つ以上のイベントまたは名前空間を指定します。 複数のイベント値はスペースで区切ります。配列を使用することもできます。有効なイベントである必要があります。 |
| childSelector | 省略可能。指定された子要素にのみ追加できるイベントハンドラを指定します(セレクター自体には追加されません。例えば廃止された delegate() メソッドなど)。 |
| data | 省略可能。関数に渡す追加データを指定します。 |
| function | 省略可能。イベント発生時に実行する関数を指定します。 |
その他の例
bind() を on() に変更する
on() を使用して bind() と同じ効果を得る方法。
delegate() を on() に変更する
on() を使用して delegate() と同じ効果を得る方法。
live() を on() に変更する
on() を使用して live() と同じ効果を得る方法。
複数のイベントハンドラを追加する
要素に複数のイベントハンドラを追加する方法。
map パラメータを使用して複数のイベントハンドラを追加する
map パラメータを使用して選択された要素に複数のイベントハンドラを追加する方法。
要素にカスタムイベントを追加する
要素にカスタム名前空間イベントを追加する方法。
関数にデータを渡す
関数にデータを渡す方法。
将来の要素にイベントハンドラを追加する
on() メソッドがまだ作成されていない要素にも適用されることを示します。
イベントハンドラを削除する
off() メソッドを使用してイベントハンドラを削除する方法。
その他の拡張機能
jQuery イベントメソッド