toggle(fn, fn2, [fn3, fn4,...])


version 1.0 以降

解説

マッチした要素がクリックされる毎に、指定された順にイベントハンドラを切り替えて実行します。

初めて要素がクリックされると、第1引数に指定したイベントハンドラが実行されます。 次に要素がクリックされると、第2引数に指定したイベントハンドラが実行されます。 以降、クリックされる毎に、引数に指定したイベントハンドラが順番に実行されます。 最後の引数の後は、第1引数が実行されます。

*指定したイベントハンドラを削除するには、unbind("click")を呼び出します。 unbind("toggle")では削除できません。(jQuery1.2.6で確認)

引数

  • fn
    Function: 実行するイベントハンドラ関数
  • fn2
    Function: 実行するイベントハンドラ関数
  • [fn3, fn4,...]オプション
    Function: 実行するイベントハンドラ関数

戻り値

  • jQuery: jQueryオブジェクト

例1:ボックスをクリックする毎に色が変わります。

$("#box").toggle(
    function(){
        $(this).css("background", "lightgreen");
    },
    function(){
        $(this).css("background", "yellow");
    },
    function(){
        $(this).css("background", "orange");
    },
    function(){
        $(this).css("background", "#c0c0c0");
    }
);

例1