jQuery triggerHandler()メソッド

jQuery 事件方法jQuery イベントメソッド

例

<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 事件方法jQuery イベントメソッド

その他の拡張機能