jQuery.triggerHandler()関数の詳しい説明

triggerHandler() 関数は、一致する各要素で指定されたタイプのイベントをトリガーするために使用されます。

さらに、イベントがトリガーされたときに、追加のパラメーターを イベント処理 関数に渡すこともできます。

この関数の機能はtrigger()関数に似ていますが、triggerHandler()関数には次の例外があります:

triggerHandler()は実行要素のデフォルトの動作(デフォルトのジャンプ動作など)をトリガーしません。リンククリックイベント、フォーム送信イベントのデフォルトのコミット動作）。

triggerHandler() は、jQuery オブジェクト内の最初に一致する要素に対してのみイベントをトリガーします。

triggerHandler() によってトリガーされたイベントは DOM ツリー内でバブルアップされないため、イベントはその祖先要素にバブルアップされません。

triggerHandler() の戻り値は、現在の jQuery オブジェクトそのものではなく、対応するイベント処理 関数の戻り値 です。

この関数はjQueryオブジェクト(インスタンス)に属します。

構文

この関数はjQuery 1.2で追加されました。

jQueryObject.triggerHandler( events [, extraArguments ] )

parameters

パラメータの説明

events 文字列型は、イベント タイプとオプションの namespace (「click」、「focus」、「keydown.myPlugin」など) を指定します。

extraArguments オプション/オブジェクト型は、イベント処理関数によって渡される追加のパラメーターです。複数のパラメータを渡したい場合は、配列として渡してください。

triggerHandler() 関数は、実行をトリガーするイベント処理関数のデフォルト パラメーター、つまり現在のイベントを表す Event オブジェクトを渡します。

パラメータ extraArguments は、イベント処理関数にさらに追加のパラメータを渡すために使用されます。 extraArguments が配列形式の場合、各要素は 関数の引数 として機能します。

戻り値

triggerHandler()関数の戻り値は任意の型で、実行をトリガーしたイベント処理関数の戻り値を返します。

例と説明

次の初期 HTML コードを参照してください:

<input id="btn1" type="button" value="点击1" />
<input id="btn2" type="button" value="点击2" />
<a id="a1" href="#">CodePlayer</a>
<div id="log"></div>

まず、イベントを上記のボタンと 要素にバインドし、triggerHandler() 関数を使用してイベントを直接トリガーします。対応するコードは次のとおりです。

var $log = $("#log");
function handler( event, arg1, arg2 ){
    var html = &#39;<br>触发元素#&#39; + this.id + &#39;的[&#39; + event.type +&#39;]事件，额外的函数参数为:&#39; + arg1 + &#39;, &#39; + arg2;
    $log.append( html );
}
var $buttons = $(":button");
// 为所有button元素的click事件绑定事件处理函数
$buttons.bind( "click", handler );
// 为所有a元素的click、mouseover、mouseleave事件绑定事件处理函数
$("a").bind( "click mouseover mouseleave", handler );
// 触发btn1的click事件
// 虽然$buttons匹配两个button元素，但只会触发第一个匹配元素的click事件
$buttons.triggerHandler("click");
/*(追加文本)
触发元素#btn1的[click]事件，额外的函数参数为:undefined, undefined
*/
$("#btn2").triggerHandler("click", "CodePlayer");
/*(追加文本)
触发元素#btn2的[click]事件，额外的函数参数为:CodePlayer, undefined
*/
// arg1 = "张三"， arg2 = 20
$("a").triggerHandler("mouseover", ["张三", 20 ] );
/*(追加文本)
触发元素#a1的[mouseover]事件，额外的函数参数为:张三, 20
*/
$("a").triggerHandler("mouseleave", { name: "张三", age: 18 } );
/*(追加文本)
触发元素#a1的[mouseleave]事件，额外的函数参数为:[object Object], undefined
*/

コードを実行します (実行するには他のコードをデモ ページにコピーしてください)

triggerHandler() 関数は、イベント処理関数に渡された Event オブジェクトに基づいて、対応するイベントをトリガーすることもできます。

りー

以上がjQuery.triggerHandler()関数の詳しい説明の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。