jQuery.queue(element, queueName, newQueue)


version 1.3 以降

解説

マッチした要素のキューを、指定されたキューで置き換えます。

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

引数

  • element
    Element: DOM要素
  • queueName
    String: キューの名前。
  • newQueue
    Array<Function>: 置き換える関数の配列

戻り値

  • jQuery: jQueryオブジェクト

例1:アニメーションが実行される毎に、キュー内の関数の数を表示します。

// アニメーション
$("#test1_run").click(function(){
    $("#block")
        .animate({height:   "0px",   opacity: 0.2}, 1500, showQueueLength)
        .animate({height:   "200px", opacity: 1.0}, 2000, showQueueLength)
        .animate({fontSize: "2.0em"}, 1500, showQueueLength)
        .animate({width:    "150px"}, 1500, showQueueLength)
        .animate({fontSize: "1.0em"}, 1500, showQueueLength)
        .animate({width:    "100px"}, 2000, showQueueLength)

    showQueueLength();
});

// キューの数を表示
function showQueueLength(){
    $("#count").text($("#block").queue().length);
};

// キューを空で置き換え
$("#test1_clear").click(function(){
    $.queue(document.getElementById("block"), "fx", []);    // 空の配列で置き換え
    $("#block").stop();   // 実行中のアニメーションを停止
    showQueueLength();    // キュー内の関数の数を表示 => 0
});


テスト1

キュー内の関数の数:0

#block

queueName は省略できない

jQuery.queue(element, [queueName]) 等とは違い、第2引数の キュー名(queueName) は省略できません。
必ず指定してください。

なお、標準の Effect キュー名は "fx" です。