trigger(type, [data])


version 1.0 以降

解説

マッチした要素に、指定されたイベントを実行します。 具体的には、標準アクション、及び、バインドされたイベントハンドラを実行します。 カスタムイベントも実行できます。

標準アクションの実行

指定されたイベントに対して、ブラウザが標準で実装しているアクションを実行します。 例えば、trigger("submit")が呼び出されると、実際にフォームが送信されます。 イベントにバインドされたイベントハンドラの1つがfalseを返すと、この標準アクションの動作を停止します。

イベントハンドラの実行

指定されたイベントに対して、バインドされたイベントハンドラを実行します。

引数

  • type
    String: 実行するイベントを表す文字列。
  • [data]オプション
    Array: イベントハンドラに渡すデータ。イベントハンドラの第2仮引数以降に展開されます。

戻り値

  • jQuery: jQueryオブジェクト

関連


例1:クリックするとイベントハンドラを実行しアニメーションします。「trigger!」ボタンを押すと、色("orange")とテキスト("trigger!")の2つのデータを渡してイベントを実行します。

// アニメーションイベントハンドラのバインド
$("#box").bind(
    "click",
    function(event, color, text){
        // 第2仮引数以降に、trigger()実行時に渡されたデータが展開される

        $(this)
            .css("background-color", color || "lightgreen")
            .text(text || "native")
            .fadeTo(2000, 0.1).fadeTo(1500, 1.0);
    }
);

// イベントを実行
$("#trigger_button").click(function(){
    // 色とテキストの2つのデータを渡してイベントを実行
    $("#box").trigger("click", ["orange", "trigger!"]);
});

例1