triggerHandler(type, [data])

version 1.2 以降

解説

マッチした要素に、指定されたイベントハンドラを実行します。 trigger(type, [data])とは違い、ブラウザの標準アクションは実行されません。

引数

type
String: 実行するイベントを表す文字列。

[data]オプション
Array: イベントハンドラに渡すデータ。イベントハンドラの第2仮引数以降に展開されます。

戻り値

jQuery: jQueryオブジェクト

関連

例

例1:チェックボックスをクリックするとイベントハンドラを実行し文字列をアニメーション表示します。
「trigger!」ボタンを押すと、クリックイベントが実行され、チェックボックスのチェックが交互に切り替わります。また、イベントハンドラが実行され、文字列がアニメーションします。
「triggerHandler!」ボタンを押すと、ブラウザ標準のアクションは実行されないため、チェックボックスの状態は変わりません。イベントハンドラは実行されるため、文字列がアニメーションします。

// クリックイベントハンドラのバインド
$("#test_1 :checkbox").click(function(){
    $(this).next().fadeIn(100).fadeOut(1000);
}).next().hide();

// クリックイベントを実行
$("#trigger_button").click(function(){
    $("#test_1 :checkbox").trigger("click");
});

// クリックイベントハンドラのみを実行
$("#trigger_handler_button").click(function(){
    $("#test_1 :checkbox").triggerHandler("click");
});