jQuery中的队列是什么?


Answers:


488

jQuery .queue().dequeue()

jQuery中的队列用于动画。您可以将它们用于任何您喜欢的目的。它们是使用每个元素存储的函数数组jQuery.data()。它们是先进先出(FIFO)。您可以通过调用将函数添加到队列中.queue(),然后使用删除(通过调用)函数.dequeue()

要了解内部jQuery队列功能,阅读源代码和查看示例将对我有很大帮助。我见过的队列功能的最佳示例之一是.delay()

$.fn.delay = function( time, type ) {
  time = jQuery.fx ? jQuery.fx.speeds[time] || time : time;
  type = type || "fx";

  return this.queue( type, function() {
    var elem = this;
    setTimeout(function() {
      jQuery.dequeue( elem, type );
    }, time );
  });
};

默认队列- fx

jQuery中的默认队列为fx。默认队列具有一些特殊属性,这些属性不与其他队列共享。

  1. 自动启动:当调用$(elem).queue(function(){});fx队列自动将dequeue在下一个功能,并运行它,如果队列尚未开始。
  2. 'inprogress'哨兵:每当您dequeue()fx队列中获取函数时,它将unshift()(推入数组的第一个位置)字符串"inprogress"-表示队列当前正在运行。
  3. 这是默认值!默认情况下,该fx队列由.animate()所有调用它的函数使用。

注意:如果使用的是自定义队列,则必须手动.dequeue()执行功能,否则它们将不会自动启动!

检索/设置队列

您可以通过.queue()不带函数参数的调用来检索对jQuery队列的引用。如果要查看队列中有多少个项目,可以使用该方法。您可以使用pushpopunshiftshift操纵队列到位。您可以通过将数组传递到来替换整个队列.queue()函数。

快速示例:

// lets assume $elem is a jQuery object that points to some element we are animating.
var queue = $elem.queue();
// remove the last function from the animation queue.
var lastFunc = queue.pop(); 
// insert it at the beginning:    
queue.unshift(lastFunc);
// replace queue with the first three items in the queue
$elem.queue(queue.slice(0,3)); 

动画(fx)队列示例:

在jsFiddle上运行示例

$(function() {
    // lets do something with google maps:
    var $map = $("#map_canvas");
    var myLatlng = new google.maps.LatLng(-34.397, 150.644);
    var myOptions = {zoom: 8, center: myLatlng, mapTypeId: google.maps.MapTypeId.ROADMAP};
    var geocoder = new google.maps.Geocoder();
    var map = new google.maps.Map($map[0], myOptions);
    var resized = function() {
        // simple animation callback - let maps know we resized
        google.maps.event.trigger(map, 'resize');
    };

    // wait 2 seconds
    $map.delay(2000);
    // resize the div:
    $map.animate({
        width: 250,
        height: 250,
        marginLeft: 250,
        marginTop:250
    }, resized);
    // geocode something
    $map.queue(function(next) {
        // find stackoverflow's whois address:
      geocoder.geocode({'address': '55 Broadway New York NY 10006'},handleResponse);

      function handleResponse(results, status) {
          if (status == google.maps.GeocoderStatus.OK) {
              var location = results[0].geometry.location;
              map.setZoom(13);
              map.setCenter(location);
              new google.maps.Marker({ map: map, position: location });
          }
          // geocoder result returned, continue with animations:
          next();
      }
    });
    // after we find stack overflow, wait 3 more seconds
    $map.delay(3000);
    // and resize the map again
    $map.animate({
        width: 500,
        height: 500,
        marginLeft:0,
        marginTop: 0
    }, resized);
});

另一个自定义队列示例

在jsFiddle上运行示例

var theQueue = $({}); // jQuery on an empty object - a perfect queue holder

$.each([1,2,3],function(i, num) {
  // lets add some really simple functions to a queue:
  theQueue.queue('alerts', function(next) { 
    // show something, and if they hit "yes", run the next function.
    if (confirm('index:'+i+' = '+num+'\nRun the next function?')) {
      next();
    }
  }); 
});

// create a button to run the queue:
$("<button>", {
  text: 'Run Queue', 
  click: function() { 
    theQueue.dequeue('alerts'); 
  }
}).appendTo('body');

// create a button to show the length:
$("<button>", {
  text: 'Show Length', 
  click: function() { 
    alert(theQueue.queue('alerts').length); 
  }
}).appendTo('body');

排队Ajax呼叫:

我开发了一个$.ajaxQueue()使用了插件$.Deferred.queue()$.ajax()也传回一个承诺,那就是请求完成时得到解决。$.ajaxQueue我对Sequencing Ajax Requests的回答中发布了该版本的另一个版本在1.4中仍然有效

/*
* jQuery.ajaxQueue - A queue for ajax requests
* 
* (c) 2011 Corey Frang
* Dual licensed under the MIT and GPL licenses.
*
* Requires jQuery 1.5+
*/ 
(function($) {

// jQuery on an empty object, we are going to use this as our Queue
var ajaxQueue = $({});

$.ajaxQueue = function( ajaxOpts ) {
    var jqXHR,
        dfd = $.Deferred(),
        promise = dfd.promise();

    // queue our ajax request
    ajaxQueue.queue( doRequest );

    // add the abort method
    promise.abort = function( statusText ) {

        // proxy abort to the jqXHR if it is active
        if ( jqXHR ) {
            return jqXHR.abort( statusText );
        }

        // if there wasn't already a jqXHR we need to remove from queue
        var queue = ajaxQueue.queue(),
            index = $.inArray( doRequest, queue );

        if ( index > -1 ) {
            queue.splice( index, 1 );
        }

        // and then reject the deferred
        dfd.rejectWith( ajaxOpts.context || ajaxOpts,
            [ promise, statusText, "" ] );

        return promise;
    };

    // run the actual query
    function doRequest( next ) {
        jqXHR = $.ajax( ajaxOpts )
            .done( dfd.resolve )
            .fail( dfd.reject )
            .then( next, next );
    }

    return promise;
};

})(jQuery);

我现在将其添加为learn.jquery.com上的文章,该网站上还有其他关于队列的出色文章,请看看。


+1。我正在研究一个基于jQuery的用户脚本,该脚本需要连接到一个PHP脚本,就像它是在客户端上运行的另一个PHP脚本一样-一次一个HTTP请求/其他操作,因此这肯定会有所帮助。只是一个问题:jQuery要求将队列附加到对象上,对吗?那么我应该使用哪个对象?$(window)
2010年

3
@idealmachine-如Ajax Queue示例所示,您实际上可以将队列事件附加到空对象:$({})
gnarf 2010年

3
此摘要非常有用。我刚刚完成了一个延迟加载程序的构建,用于延迟对屏幕底部以下的大量内容的请求,直到将其滚动到视图中为止。使用jQuery的queue()可使那些Ajax请求非常流畅(即使您直接跳到页面底部)。谢谢!
杰夫斯坦顿

14
很高兴发现您仍在更新此版本以更新jQuery。+1 :)
Shaz

3
要为刚刚学习队列和Promise等的人添加一件事-在ajaxQueue示例中,对您希望在()中排队的ajax请求的$ .ajaxQueue()调用将返回一个Promise。您等待直到队列为空的方式是通过promise.done(function(){alert(“ done”)});;。花了我一个小时找到这个,所以希望这可以帮助其他人节省他们的时间!
罗斯

42

要了解队列方法,您必须了解jQuery如何进行动画处理。如果您一个接一个地编写多个动画方法调用,则jQuery将创建一个“内部”队列并将这些方法调用添加到该队列中。然后,它一一运行那些动画调用。

考虑以下代码。

function nonStopAnimation()
{
    //These multiple animate calls are queued to run one after
    //the other by jQuery.
    //This is the reason that nonStopAnimation method will return immeidately
    //after queuing these calls. 
    $('#box').animate({ left: '+=500'}, 4000);
    $('#box').animate({ top: '+=500'}, 4000);
    $('#box').animate({ left: '-=500'}, 4000);

    //By calling the same function at the end of last animation, we can
    //create non stop animation. 
    $('#box').animate({ top: '-=500'}, 4000 , nonStopAnimation);
}

使用“队列” /“出队”方法,您可以控制此“动画队列”。

默认情况下,动画队列的名称为“ fx”。我在这里创建了一个示例页面,其中包含各种示例,这些示例将说明如何使用队列方法。

http://jsbin.com/zoluge/1/edit?html,输出

以上示例页面的代码:

$(document).ready(function() {
    $('#nonStopAnimation').click(nonStopAnimation);

    $('#stopAnimationQueue').click(function() {
        //By default all animation for particular 'selector'
        //are queued in queue named 'fx'.
        //By clearning that queue, you can stop the animation.
        $('#box').queue('fx', []);
    });

    $('#addAnimation').click(function() {
        $('#box').queue(function() {
            $(this).animate({ height : '-=25'}, 2000);
            //De-queue our newly queued function so that queues
            //can keep running.
            $(this).dequeue();
        });
    });

    $('#stopAnimation').click(function() {
        $('#box').stop();
    });

    setInterval(function() {
        $('#currentQueueLength').html(
         'Current Animation Queue Length for #box ' + 
          $('#box').queue('fx').length
        );
    }, 2000);
});

function nonStopAnimation()
{
    //These multiple animate calls are queued to run one after
    //the other by jQuery.
    $('#box').animate({ left: '+=500'}, 4000);
    $('#box').animate({ top: '+=500'}, 4000);
    $('#box').animate({ left: '-=500'}, 4000);
    $('#box').animate({ top: '-=500'}, 4000, nonStopAnimation);
}

现在您可能会问,为什么我要打扰这个队列?通常,你不会。但是,如果您要控制复杂的动画序列,那么队列/出队方法是您的朋友。

另请参阅关于jQuery组的有关创建复杂动画序列的有趣对话。

http://groups.google.com/group/jquery-zh-CN/browse_thread/thread/b398ad505a9b0512/f4f3e841eab5f5a2?lnk=gst

动画演示:

http://www.exfer.net/test/jquery/tabslide/

让我知道您是否还有问题。


20

队列中的多个对象动画

这是队列中多个对象动画的简单示例。

jQuery使我们只能对一个对象进行排队。但是在动画功能中,我们可以访问其他对象。在此示例中,我们在#q对象上设置队列,同时为#box1和#box2对象设置动画。

将队列视为函数数组。因此,您可以将队列作为数组进行操作。您可以使用推,弹出,取消移位,移位来操纵队列。在此示例中,我们从动画队列中删除了最后一个函数,并将其插入到开头。

完成后,我们通过dequeue()函数启动动画队列。

见jsFiddle

的HTML:

  <button id="show">Start Animation Queue</button>
  <p></p>
  <div id="box1"></div>
  <div id="box2"></div>
  <div id="q"></div>

js:

$(function(){

 $('#q').queue('chain',function(next){  
      $("#box2").show("slow", next);
  });


  $('#q').queue('chain',function(next){  
      $('#box1').animate(
          {left: 60}, {duration:1000, queue:false, complete: next}
      )
  });    


  $('#q').queue('chain',function(next){  
      $("#box1").animate({top:'200'},1500, next);
  });


  $('#q').queue('chain',function(next){  
      $("#box2").animate({top:'200'},1500, next);
  });


  $('#q').queue('chain',function(next){  
      $("#box2").animate({left:'200'},1500, next);
  });

  //notice that show effect comes last
  $('#q').queue('chain',function(next){  
      $("#box1").show("slow", next);
  });

});

$("#show").click(function () {
    $("p").text("Queue length is: " + $('#q').queue("chain").length);

    // remove the last function from the animation queue.
    var lastFunc = $('#q').queue("chain").pop();
    // insert it at the beginning:    
    $('#q').queue("chain").unshift(lastFunc);

    //start animation queue
    $('#q').dequeue('chain');
});

CSS:

        #box1 { margin:3px; width:40px; height:40px;
                position:absolute; left:10px; top:60px; 
                background:green; display: none; }
        #box2 { margin:3px; width:40px; height:40px;
                position:absolute; left:100px; top:60px; 
                background:red; display: none; }
        p { color:red; }  

15

它允许您将动画排队...例如,代替此

$('#my-element').animate( { opacity: 0.2, width: '100px' }, 2000);

其衰要素,将宽度100像素在同一时间。使用队列可以登台动画。因此,一个接一个地完成。

$("#show").click(function () {
    var n = $("div").queue("fx");
    $("span").text("Queue length is: " + n.length);
});

function runIt() {
    $("div").show("slow");
    $("div").animate({left:'+=200'},2000);
    $("div").slideToggle(1000);
    $("div").slideToggle("fast");
    $("div").animate({left:'-=200'},1500);
    $("div").hide("slow");
    $("div").show(1200);
    $("div").slideUp("normal", runIt);
}
runIt();

来自http://docs.jquery.com/Effects/queue的示例


这是不正确的。当您有多个“动画”调用时,jQuery会将它们放在队列中以一个接一个地执行它们。现在,使用队列方法,您可以访问该队列并进行操作(如果需要)。
解决方案

1
@SolutionYogi-如果您觉得答案不正确,请编辑我的答案-答案为CW,并且您的代表足够。
alex

8

这个线程对我的问题有很大帮助,但是我以不同的方式使用$ .queue,并认为我会在这里发布我想出的东西。我需要的是要触发的一系列事件(框架),但是要动态构建该序列。我有不同数量的占位符,每个占位符应包含动画序列的图像。数据保存在数组数组中,因此我遍历数组以为每个占位符构建每个序列,如下所示:

/* create an empty queue */
var theQueue = $({});
/* loop through the data array */
for (var i = 0; i < ph.length; i++) {
    for (var l = 0; l < ph[i].length; l++) {
        /* create a function which swaps an image, and calls the next function in the queue */
        theQueue.queue("anim", new Function("cb", "$('ph_"+i+"' img').attr('src', '/images/"+i+"/"+l+".png');cb();"));
        /* set the animation speed */
        theQueue.delay(200,'anim');
    }
}
/* start the animation */
theQueue.dequeue('anim');

这是我到达的脚本的简化版本,但是应该显示出原理-将函数添加到队列时,使用Function构造函数添加该函数-这样,可以使用循环中的变量动态编写函数( s)。注意将函数传递给next()调用参数的方式,并在最后调用该参数。在这种情况下,该函数没有时间依赖性(它不使用$ .fadeIn或类似的东西),因此我使用$ .delay交错帧。


$ .queue基本上是对存储在$ .data中的数组的推送,这就是为什么您必须手动告诉它使用cb()执行下一个函数的原因;我的理解正确吗?
八眼2012年

-1

功能makeRedmakeBlack使用queuedequeue彼此执行。效果是,“#wow”元素连续闪烁。

<html>
  <head>
    <script src="http://code.jquery.com/jquery-1.9.1.js"></script>
    <script type="text/javascript">
      $(document).ready(function(){
          $('#wow').click(function(){
            $(this).delay(200).queue(makeRed);
            });
          });

      function makeRed(){
        $('#wow').css('color', 'red');
        $('#wow').delay(200).queue(makeBlack);
        $('#wow').dequeue();
      }

      function makeBlack(){
        $('#wow').css('color', 'black');
        $('#wow').delay(200).queue(makeRed);
        $('#wow').dequeue();
      }
    </script>
  </head>
  <body>
    <div id="wow"><p>wow</p></div>
  </body>
</html>
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.