jQuery triggerHandler()メソッド
例
<input> 要素の select イベントをトリガーする:
$("button").click(function(){
$("input").triggerHandler("select");
});
試してみる »
定義と使い方
triggerHandler() メソッドは、選択された要素で指定されたイベントをトリガーします。
このメソッドの戻り値は、チェーン可能な jQuery オブジェクトではなく、イベントハンドラ関数の戻り値です。また、ハンドラがトリガーされない場合、このメソッドは undefined を返します。
このメソッドはtrigger()メソッドと似ていますが、trigger() はイベントのデフォルト動作(フォーム送信など)もトリガーする点が異なります。
trigger() メソッドとの相違点:
- イベント(フォーム送信など)のデフォルト動作を引き起こしません。
- .trigger() は jQuery オブジェクトが一致するすべての要素を操作しますが、.triggerHandler() は最初に一致する要素のみに影響します。
- .triggerHandler() によって作成されたイベントは DOM ツリー内をバブリングしません。ターゲット要素が直接処理しない場合、何も発生しません。
例
triggerHandler() と .trigger() の比較:
$( "#old" ).click(function() {
$( "input" ).trigger( "focus" );
});
$( "#new" ).click(function() {
$( "input" ).triggerHandler( "focus" );
});
$( "input" ).focus(function() {
$( "<span>Focused!</span>" ).appendTo( "body" ).fadeOut( 1000 );
});
試してみる »
構文
$(selector).triggerHandler(event,param1,param2,...)
| パラメータ | 説明 |
|---|---|
| event | 必須。指定された要素でトリガーするイベントを指定します。 |
| param1,param2,... | 省略可能。イベントハンドラに渡される追加のパラメータ。 追加のパラメータは、カスタムイベントに特に便利です。 |
その他の例
カスタムイベントに追加のパラメータを渡す
カスタムイベントハンドラに追加のパラメータを渡す方法。
trigger() と triggerHandler() の違い
trigger() と triggerHandler() の違いを示します。
その他の拡張機能
jQuery イベントメソッド