jQuery イベント - triggerHandler() メソッド
例
input 元素の select イベントをトリガー:
$("button").click(function(){ $("input").triggerHandler("select"); });
定義と使用方法
triggerHandler() メソッドは選択された要素の指定されたイベントタイプをトリガーしますが、ブラウザのデフォルトアクションを実行せず、イベントバブルも生成しません。
triggerHandler() メソッドは trigger() メソッドに似ていますが、イベント(例えば、フォームの提出)のデフォルトの行動をトリガーしないで、最初のマッチする要素のみを影響します。
trigger() メソッドとの違い
- デフォルトの行動(例えば、フォームの 提出)を引き起こしません。
- .trigger() はマッチするすべての jQuery オブジェクトを操作しますが、.triggerHandler() は最初のマッチする要素のみを影響します。
- triggerHandler() で作成されたイベントは DOM 木内でバブルしません;ターゲット要素が直接処理しない場合、何も起こりません。
- このメソッドの返値はイベントハンドラの返値であり、jQuery オブジェクトのリンク性を持たない。また、ハンドラがトリガーされない場合、このメソッドは undefined を返します。
イベントトリガー
選択された要素がトリガーするイベントを定義。
文法
$(selector).triggerHandler(event,param1,param2,...])
パラメータ | 説明 |
---|---|
event | 必須。指定された要素がトリガーするイベントを定義。 |
[param1,param2,...] | オプション。イベントハンドラに渡される追加のパラメータ。 |