jQuery.dequeue(element, [queueName])


version 1.3 以降

解説

DOM要素に関連付けられているキューの先頭から、処理を取り出し実行します。

通常の使用では、jQueryオブジェクトに対するメソッドの dequeue([queueName]) の方が使いやすいです。

概念図

引数

  • element
    Element: DOM要素
  • [queueName]オプション
    String: キューの名前。指定しない場合は、デフォルトの fx キューを対象とします。

戻り値

  • jQuery: jQueryオブジェクト

例1:アニメーション毎に"green"クラスを切り替えて色が変わるように、キューに登録します。

$("#test1_run").click(function(){
    $("#block").animate({height: "hide", opacity: 0.2}, 1500, "linear");
    $.queue(document.getElementById("block"), "fx", function(){     // キューに追加
        $(this).toggleClass("green");
        $.dequeue(this);    // 次の処理を取り出して実行
    });
    $("#block").animate({height: "show", opacity: 1.0}, 2000, "swing");
});

テスト1

#block