عرض مصدر jQuery/clearQueue

<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.clearQueue()‎‎</code>‎ في jQuery}}</noinclude>
== <code>‎.clearQueue( [queueName ] )‎</code> ==

===القيمة المعادة===
كائن [[jQuery/jQuery|jQuery]].
===الوصف===
يُستخدَم التابع <code>‎.clearQueue()‎</code> في إزالة كافّة العناصر التي لم تُشغَّل حتى الآن من الطابور.

=== <code>‎.clearQueue( [queueName ] )‎</code> ===
أضيفت في الإصدار: 1.4.

==== <code>queueName</code> ====
سلسلة نصيّة، وتُمثِّل اسم الطابور. القيمة الافتراضيّة هي <code>fx</code>، وهو طابور التأثيرات المعياري.

عندما يُستدعى التّابع ‎<code>.clearQueue()</code>‎، فستُزال من الطابور كافّة الدوال الموجودة فيه والتي لم تُنفَّذ بعد. عندما يُستخدَم هذا التّابع دون وسيط، فسيُزيل ‎<code>.clearQueue()</code>‎ الدوال المتبقيّة من <code>fx</code> وهو طابور التأثيرات المعياري. يُشابِه هذا التّابع بهذه الطريقة ‎<code>.stop(true)</code>‎، ولكن يُفترَض استخدام التّابع <code>‎.stop()‎</code> مع التحريك فقط، بينما يُمكِن استخدام التّابع ‎<code>.clearQueue()</code>‎ لإزالة أي دالة مُضافة لطابور jQuery العام باستخدام التّابع <code>‎.queue()</code>‎.

=== أمثلة ===
تفريغ الطابور:<syntaxhighlight lang="html">
<!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>
</syntaxhighlight>

==<span>مصادر</span>==
*<span>[http://api.jquery.com/clearQueue/ صفحة التابع ‎.clearQueue()‎‎‎ في توثيق jQuery الرسمي].</span>
[[تصنيف:jQuery]]
[[تصنيف:jQuery Effects]]
[[تصنيف:jQuery Data]]
[[تصنيف:jQuery Utilities]]