الفرق بين المراجعتين لصفحة: «jQuery/clearQueue»

من موسوعة حسوب
لا ملخص تعديل
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.clearQueue()‎‎</code>‎ في jQuery}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.clearQueue()‎‎</code>‎ في jQuery}}</noinclude>
== <code>‎.clearQueue( [queueName ] )‎</code> ==
== <code>‎.clearQueue( [queueName ] )‎</code> ==



مراجعة 20:10، 25 مايو 2018

‎.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>

مصادر