jQuery API の clearQueue( [queueName] ) は、指定した要素のキューからまだ実行されていない全ての項目を削除するメソッド。
引数
- [queueName]
オプション。
まだ実行されていない全ての項目を削除したいキューを、名前で指定できる。指定がない場合、デフォルトのエフェクトキューからまだ実行されていない全ての項目を削除する。
実装例（サンプル）
実装例（サンプル）の動作について
- 「action」ボタンをクリックすると、オレンジ色のブロックの幅が50pxから200pxへアニメーション変化し、次に、ブロックの背景色がピンク色になり、最後に、高さが50pxから200pxへアニメーション変化する。
- アニメーション中に、「clearQueue()」ボタンをクリックすると、その時点で、アニメーションを停止する。
実装例（サンプル）のソースコード
JavaScript
<script type="text/javascript">
<!--
jQuery( function() {
jQuery( '#jquery-api-animate-click-2' ) . click( function() {
jQuery( '#jquery-api-animate' )
. clearQueue()
. stop();
} );
jQuery( '#jquery-api-animate-click' ) . click( function() {
jQuery( '#jquery-api-animate' )
. clearQueue()
. stop()
. css(
{
width: 50,
height: 50,
backgroundColor: 'orange',
}
)
. animate(
{
width: 200,
},
{
duration: 2000,
}
)
. queue( function() {
jQuery( this ) . css( { backgroundColor: 'pink' } ) . dequeue();
} )
. animate(
{
height: 200,
},
{
duration: 2000,
}
);
} );
} );
// -->
</script>
<!--
jQuery( function() {
jQuery( '#jquery-api-animate-click-2' ) . click( function() {
jQuery( '#jquery-api-animate' )
. clearQueue()
. stop();
} );
jQuery( '#jquery-api-animate-click' ) . click( function() {
jQuery( '#jquery-api-animate' )
. clearQueue()
. stop()
. css(
{
width: 50,
height: 50,
backgroundColor: 'orange',
}
)
. animate(
{
width: 200,
},
{
duration: 2000,
}
)
. queue( function() {
jQuery( this ) . css( { backgroundColor: 'pink' } ) . dequeue();
} )
. animate(
{
height: 200,
},
{
duration: 2000,
}
);
} );
} );
// -->
</script>
CSS
<style type="text/css">
<!--
div#jquery-api-animate {
background-color: orange;
height: 200px;
width: 200px;
}
-->
</style>
<!--
div#jquery-api-animate {
background-color: orange;
height: 200px;
width: 200px;
}
-->
</style>
HTML
<p>
<button id="jquery-api-animate-click">action</button>
<button id="jquery-api-animate-click-2">clearQueue()</button>
</p>
<div id="jquery-api-animate"></div>
<button id="jquery-api-animate-click">action</button>
<button id="jquery-api-animate-click-2">clearQueue()</button>
</p>
<div id="jquery-api-animate"></div>