.queue()

类别：效果 > 自定义 | 数据 | 实用工具
显示或操纵要在匹配的元素上执行的函数队列。

内容：

.queue( [queueName ] )返回类型：Array

描述：显示要在匹配的元素上执行的函数的队列。

示例：

显示队列的长度。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>queue demo</title>
  <style>
  div {
    margin: 3px;
    width: 40px;
    height: 40px;
    position: absolute;
    left: 0px;
    top: 60px;
    background: green;
    display: none;
  }
  div.newcolor {
    background: blue;
  }
  p {
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>The queue length is: <span></span></p>
<div></div>
 
<script>
var div = $( "div" );
 
function runIt() {
  div
    .show( "slow" )
    .animate({ left: "+=200" }, 2000 )
    .slideToggle( 1000 )
    .slideToggle( "fast" )
    .animate({ left: "-=200" }, 1500 )
    .hide( "slow" )
    .show( 1200 )
    .slideUp( "normal", runIt );
}
 
function showIt() {
  var n = div.queue( "fx" );
  $( "span" ).text( n.length );
  setTimeout( showIt, 100 );
}
 
runIt();
showIt();
</script>
 
</body>
</html>

演示：

.queue( [queueName ], newQueue )返回类型：jQuery

描述：操纵要执行的函数的队列，对每个匹配的元素执行一次。

  • 增补版本：1.2.queue( [queueName ], newQueue )

    • queueName
      类型：String
      一个字符串，包含了列表的名列。默认为fx，是标准效果队列。
    • newQueue
      类型：Array
      用来替换当前队列内容的函数的数组。

  • 增补版本：1.2.queue( [queueName ], callback )

    • queueName
      类型：String
      一个字符串，包含了列表的名列。默认为fx，是标准效果队列。
    • callback
      类型：Function( Function next() )
      要添加到队列的新函数，当该函数被调用时，将弹出队列中的下一个元素。

每个元素可以利用jQuery附加一个或多个函数的队列。在大多数应用中，只使用一个队列（称为fx）。队列允许在一个元素上异步地调用一连串的动作，而不终止程序执行。典型的例子就是在一个元素上调用多重动画的方法对一个元素。例如：

1
 
$( "#foo" ).slideUp().fadeIn();

如果执行了此语句，元素立即开始它的滑动动画，但是放在fx队列上的褪色过渡，需要等到滑动过渡完成之后才执行。

.queue()方法允许我们直接操纵函数的队列。用回调函数调用.queue()相当有用；它允许我们把一些新函数放在队列的末尾。回调函数对jQuery集合中的每个元素执行一次。

此功能类似于用动画方法提供一个回调函数，但是并不要求回调函数在实施动画时给出。

1
2
3
4
5
 
$( "#foo" ).slideUp();
$( "#foo" ).queue(function() {
  alert( "Animation complete." );
  $( this ).dequeue();
});

这等同于：

1
2
3
 
$( "#foo" ).slideUp(function() {
  alert( "Animation complete." );
});

请注意，如果用.queue()添加函数，我们应该确保.dequeue()最终会被调用，从而下一个函数依次执行。

自从jQuery 1.4以来，被调用的函数传递给另一个函数作为第一个参数。在调用时，它会自动从队列中弹出下一项，并保持队列移动。我们可以像下面这样使用：

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

示例：

队列一个自定义函数。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>queue demo</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>
 
Click here...
<div></div>
 
<script>
$( document.body ).click(function() {
  $( "div" )
    .show( "slow" )
    .animate({ left: "+=200" }, 2000 )
    .queue(function() {
      $( this ).addClass( "newcolor" ).dequeue();
    })
    .animate({ left: "-=200" }, 500 )
    .queue(function() {
      $( this ).removeClass( "newcolor" ).dequeue();
    })
    .slideUp();
});
</script>
 
</body>
</html>

演示：

设置队列数组以删除队列。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>queue demo</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">Start</button>
<button id="stop">Stop</button>
<div></div>
 
<script>
$( "#start" ).click(function() {
  $( "div" )
    .show( "slow" )
    .animate({ left: "+=200" }, 5000 )
    .queue(function() {
      $( this ).addClass( "newcolor" ).dequeue();
    })
    .animate({ left: '-=200' }, 1500 )
    .queue(function() {
      $( this ).removeClass( "newcolor" ).dequeue();
    })
    .slideUp();
});
$( "#stop" ).click(function() {
  $( "div" )
    .queue( "fx", [] )
    .stop();
});
</script>
 
</body>
</html>

演示：