التابع `‎‎.clearQueue()‎‎`‎ في 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>

مصادر

صفحة التابع ‎.clearQueue()‎‎‎ في توثيق jQuery الرسمي.