الفرق بين المراجعتين لصفحة: «jQuery/clearQueue»
< jQuery
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 14: | سطر 14: | ||
سلسلة نصيّة، وتُمثِّل اسم الطابور. القيمة الافتراضيّة هي <code>fx</code>، وهو طابور التأثيرات المعياري. | سلسلة نصيّة، وتُمثِّل اسم الطابور. القيمة الافتراضيّة هي <code>fx</code>، وهو طابور التأثيرات المعياري. | ||
عندما يُستدعى التّابع <code>.clearQueue()</code>، فستُزال من الطابور كافّة الدوال الموجودة فيه والتي لم تُنفَّذ. عندما يُستخدَم هذا التّابع بدون وسيط، فسيُزيل <code>.clearQueue()</code> الدوال المتبقيّة من <code>fx</code> وهو طابور التأثيرات المعياري. يُشابِه هذا التّابع بهذه الطريقة <code>.stop(true)</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]] | |||
مراجعة 20:09، 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>