التابع .clearQueue() في jQuery
< jQuery
اذهب إلى التنقل
اذهب إلى البحث
مراجعة 09:21، 24 يونيو 2018 بواسطة عبد اللطيف ايمش (نقاش | مساهمات) (استبدال النص - 'JQuery' ب'jQuery')
.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>