التابع `‎.dequeue()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎`‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

`‎.dequeue( [queueName ] )‎`

القيمة المعادة

يُعيد كائنًا من النوع jQuery.

الوصف

ينفذ هذا التابع الدالة التالية في طابور الانتظار للعناصر المتطابقة.

أُضيف مع الإصدار: 1.2

`‎.dequeue( [queueName ] )‎`

`queueName`

سلسلة نصية تحتوي على اسم الطابور. وقيمتها الافتراضية fx وهو اسم طابور التأثيرات القياسية.

عند استدعاء ‎.dequeue()‎، تتم إزالة الدالة التالية في طابور (queue) الانتظار، ثم تُنفَّذ. ينبغي لهذه الدالة بدورها (بشكل مباشر أو غير مباشر) التسبب في استدعاء ‎.dequeue()‎، بحيث يستمر التسلسل.

أمثلة

استخدام dequeue لإنهاء دالة انتظار مخصصة تسمح لطابور الانتظار بالاستمرار:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>dequeue مثال على التابع</title>
  <style>
  div {
    margin: 3px;
    width: 50px;
    position: absolute;
    height: 50px;
    left: 10px;
    top: 30px;
    background-color: yellow;
  }
  div.red {
    background-color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<button>إبدأ</button>
<div></div>
 
<script>
$( "button" ).click(function() {
  $( "div" )
    .animate({ left:"+=200px" }, 2000 )
    .animate({ top:"0px" }, 600 )
    .queue(function() {
      $( this ).toggleClass( "red" ).dequeue();
    })
    .animate({ left:"10px", top:"30px" }, 700 );
});
</script>
 
</body>
</html>

مصادر

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