clearQueue([queueName])


version 1.4 以降

解説

キューにある、実行されていない関数を消去します。

引数

  • [queueName]オプション
    String: 消去するキューの名前。指定しない場合は、デフォルトの fx キューを消去します。

戻り値

  • jQuery: jQueryオブジェクト

例1:アニメーションが実行される毎に、キュー内の関数の数を表示します。
clearQueue ボタンをクリックすると、未実行のキューの関数を消去します。現在実行中のアニメーションが終了したら、残りのアニメーションは実行されません。(実行中のアニメーションは最後まで実行されること、また、キュー内の関数の数が0になるのを確認してください。)

// キューをクリア
$("#test1_clear").click(function(){
    $("#test1 .block").clearQueue();

    showQueueLength();
});

// アニメーション
$("#test1_run").click(function(){
    $("#test1 .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($("#test1 .block").queue().length);
};



テスト1

キュー内の関数の数:0



.block