jQuery Data - jQuery.queue() Methode

Voorbeeld

Toon de lengte van de wachtrij:

function showIt() {
  var n = div.queue("fx");
  $("span").text( n.length );      
  setTimeout(showIt, 100);
}

亲自试一试

Definitie en gebruik

De queue() methode toont of manipuleert de functie-wachtrij die wordt uitgevoerd op overeenkomende elementen.

Opmerking:Dit is een laagste niveau-methode; gebruik .queue() Veel handiger.

Syntaxis

.queue(queueName)
Parameters Beschrijving
queueName Optioneel. Een stringwaarde die de naam van de reeks bevat. Standaard is dit fx, de standaard effectreeks.

Beheer van de wachtrij

De queue() methode manipuleert de functie-wachtrij die wordt uitgevoerd op overeenkomende elementen.

Syntaxis

.queue(queueName,newQueue)
Parameters Beschrijving
queueName Optioneel. Een stringwaarde die de naam van de reeks bevat. Standaard is dit fx, de standaard effectreeks.

Gedetailleerde uitleg

Elk element kan een tot meerdere functie-wachtrijen hebben die door jQuery worden toegevoegd. In de meeste toepassingen wordt slechts één wachtrij gebruikt (genaamd fx). De wachtrij voert actieseries asynchronelementen uit op elementen zonder de uitvoering van het programma te beëindigen. Een typisch voorbeeld is het aanroepen van meerdere animatiemethoden op elementen. Bijvoorbeeld:

$('#foo').slideUp().fadeIn();

当这条语句执行时,元素会立即开始其滑动动画,但是淡入过渡被置于 fx 队列,只有当滑动过渡完成后才会被调用。

.queue() 方法允许我们直接对这个函数队列进行操作。调用带有回调函数的 .queue() 方法特别有用;它允许我们在队列末端放置一个新函数。

这个特性与动画方法提供回调函数类似,但是无需在动画执行时设置回调函数。

$('#foo').slideUp();
$('#foo').queue(function() {
  alert('Animation complete.');
  $("this").dequeue();
});;

等价于:

$('#foo').slideUp(function() {
  alert('Animation complete.');
);

请注意,当通过 .queue() 添加函数时,我们应当确保最终调用了 .dequeue(),这样下一个排队的函数才能执行。

例子 1

对自定义函数进行队列操作:

$("document.body").click(function () {
  $("div").show("slow");
  $("div").animate({left:'+=200'},2000);
  $("div").queue(function () {
    $("this").addClass("newcolor");
    $("this").dequeue();
  });;
  $("div").animate({left:'-=200'},500);
  $("div").queue(function () {
    $("this").removeClass("newcolor");
    $("this").dequeue();
  });;
  $("div").slideUp();
);

亲自试一试

例子 2

设置队列数组来删除队列:

$("#start").click(function () {
  $("div").show("slow");
  $("div").animate({left:'+=200'},5000);
  $("div").queue(function () {
    $("this").addClass("newcolor");
    $("this").dequeue();
  );
  $("div").animate({left:'-=200'},1500);
  $("div").queue(function () {
    $("this").removeClass("newcolor");
    $("this").dequeue();
  );
  $("div").slideUp();
);
$("#stop").click(function () {
  $("div").queue("fx", []);
  $("div").stop();
);

亲自试一试