الفرق بين المراجعتين ل"jQuery/clearQueue"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.clearQueue()‎‎</code>‎ في jQuery}}</noinclude>')
 
ط (استبدال النص - 'JQuery' ب'jQuery')
 
(6 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.clearQueue()‎‎</code>‎ في jQuery}}</noinclude>
 
<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]]

المراجعة الحالية بتاريخ 09:21، 24 يونيو 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>

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=jQuery/clearQueue&oldid=11172"