• 首页
  • css3教程
  • html5教程
  • jQuery手册
  • php7教程
  • MySQL手册
  • apache手册
  • queue()

    显示或操作匹配的元素上已经执行的函数列队。

    Contents:

    • .queue([queueName ])
      • queue([queueName ])
    • .queue([queueName ], newQueue)
      • queue([queueName ], newQueue)
      • queue([queueName ], callback(next))

    queue([queueName ])

    显示在匹配的元素上的已经执行的函数列队。

    • .queue([queueName ])
      • queueName类型: String。一个含有队列名的字符串。默认是fx,标准的动画队列。

    例子

    显示列队的长度。

    <!DOCTYPE html>
    <html>
    <head>
      <style>div { margin:3px; width:40px; height:40px;
            position:relative; left:0px; top:60px;
            background:green; display:none; }
      div.newcolor { background:blue; }
      p { color:red; }  </style>
      <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
    </head>
    <body>
     
      <p>The queue length is: <span></span></p>
      <div></div>
    <script>
    var div = $("div");
     
    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);
    }
     
    function showIt() {
      var n = div.queue("fx");
      $("span").text( n.length );
      setTimeout(showIt, 100);
    }
     
    runIt();
    showIt();
    </script>
     
    </body>
    </html>
    

    The queue length is:

    queue([queueName ], newQueue)

    在匹配元素上操作已经附加函数的列表。

    • .queue([queueName ], newQueue)
      • queueName类型: String。一个含有队列名的字符串。默认是fx,标准的动画队列。
      • newQueue类型: Array。一个替换当前列队内容的函数数组。
    • .queue([queueName ], callback(next))
      • queueName类型: String。一个含有队列名的字符串。默认是fx,标准的动画队列。
      • callback Type: Function(Function next())要添加进队列的函数。下一个动画队列执行时会调用这个函数。

    每个元素可以通过jQuery,包含一个或多个函数队列。在大多数应用中,只有一个列队(访问fx)被使用。队列允许一个元素来异步的访问一连串的动作,而不终止程序执行。典型的例子就是在一个元素上调用多重动画的方法对一个元素。例如:

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

    当这个语句被执行,这个元素开始立即做滑动动画,但渐入动画放置在fx列队在,只有当滑动动画完成后才会被执行。

    queue()方法允许我们直接操纵这个函数队列。用一个回调函数访问queue()特别的有用;它让我们把新函数置入到队列的末端。为jQuery集合中的每个元素执行一次回调函数。

    该函数的功能类似于在动画方法中提供了回调函数,但是不要求在动画执行时指定回调函数。

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

    这是相当于:

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

    值得注意的是,当使用.queue()添加一个函数的时候,我们应该保证在函数最后调用了jQuery.dequeue(),这样就能让队列中的其它函数按顺序执行。

    从jQuery 1.4开始,向队列中追加函数时,可以向该函数中传入另一个函数,作为第一个参数。当调用函数时,会自动从函数队列中弹出下一个项目,保证队列中函数的继续进行。我们可以像下面这样使用:

    $("#test").queue(function(next) {
        // Do some stuff...
        next();
    });
    

    例子:

    Queue a custom function.

    <!DOCTYPE html>
    <html>
    <head>
      <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://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
    </head>
    <body>
      Click here...
      <div></div>
    <script>$(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();
        });</script>
     
    </body>
    </html>
    

    Click here...

    Set a queue array to delete the queue.

    <!DOCTYPE html>
    <html>
    <head>
      <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://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
    </head>
    <body>
      <button id="start">Start</button>
      <button id="stop">Stop</button>
      <div></div>
    <script>$("#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();
        });</script>
     
    </body>
    </html>