التابع .clearQueue() في jQuery
< jQuery
اذهب إلى التنقل
اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
.clearQueue( [queueName ] )
القيمة المعادة
كائن jQuery.
الوصف
يُستخدَم التابع .clearQueue() في إزالة كافّة العناصر التي لم تُشغَّل حتى الآن من الطابور.
.clearQueue( [queueName ] )
أضيفت في الإصدار: 1.4.
queueName
سلسلة نصيّة، وتُمثِّل اسم الطابور. القيمة الافتراضيّة هي fx، وهو طابور التأثيرات المعياري.
عندما يُستدعى التّابع .clearQueue()، فستُزال من الطابور كافّة الدوال الموجودة فيه والتي لم تُنفَّذ بعد. عندما يُستخدَم هذا التّابع دون وسيط، فسيُزيل .clearQueue() الدوال المتبقيّة من fx وهو طابور التأثيرات المعياري. يُشابِه هذا التّابع بهذه الطريقة .stop(true)، ولكن يُفترَض استخدام التّابع .stop() مع التحريك فقط، بينما يُمكِن استخدام التّابع .clearQueue() لإزالة أي دالة مُضافة لطابور jQuery العام باستخدام التّابع .queue().
أمثلة
تفريغ الطابور:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>clearQueue مثال عن التابع</title>
<style>
div {
margin: 3px;
width: 40px;
height: 40px;
position: absolute;
left: 0px;
top: 30px;
background: green;
display: none;
}
div.newcolor {
background: blue;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button id="start">ابدأ</button>
<button id="stop">توقف</button>
<div></div>
<script>
$( "#start" ).click(function() {
var myDiv = $( "div" );
myDiv.show( "slow" );
myDiv.animate({
left:"+=200"
}, 5000 );
myDiv.queue(function() {
var that = $( this );
that.addClass( "newcolor" );
that.dequeue();
});
myDiv.animate({
left:"-=200"
}, 1500 );
myDiv.queue(function() {
var that = $( this );
that.removeClass( "newcolor" );
that.dequeue();
});
myDiv.slideUp();
});
$( "#stop" ).click(function() {
var myDiv = $( "div" );
myDiv.clearQueue();
myDiv.stop();
});
</script>
</body>
</html>