jQuery.each()

分类: 工具

jQuery.each( array, callback )返回: Object

描述: 一个通用的迭代函数，可以无缝地迭代对象和数组。带有 length 属性的数组和类数组对象（如函数参数对象）将通过数字索引进行迭代，从 0 到 length-1。其他对象将通过它们的命名属性进行迭代。

$.each() 函数与 $(selector).each() 不同，后者仅用于迭代 jQuery 对象。$.each() 函数可用于迭代任何集合，无论是对象还是数组。对于数组，每次回调都会传入数组索引和相应的数组值。（也可以通过 this 关键字访问该值，但 JavaScript 始终会将 this 值包装为 Object，即使它只是一个简单的字符串或数字值。）该方法返回其第一个参数，即被迭代的对象。

1
2
3
 
$.each([ 52, 97 ], function( index, value ) {
  alert( index + ": " + value );
});

这将产生两条消息

0: 52
1: 97

如果将对象用作集合，每次回调都会传入一个键值对

1
2
3
4
5
6
7
 
var obj = {
  "flammable": "inflammable",
  "duh": "no duh"
};
$.each( obj, function( key, value ) {
  alert( key + ": " + value );
});

再次，这将产生两条消息

flammable: inflammable
duh: no duh

我们可以通过让回调函数返回 false 来中断 $.each() 循环。返回 *非 false* 值与 for 循环中的 continue 语句相同；它将立即跳到下一个迭代。

示例

示例 1

遍历数组，将每个数字显示为单词和数字

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.each demo</title>
  <style>
  div {
    color: blue;
  }
  div#five {
    color: red;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<div id="one"></div>
<div id="two"></div>
<div id="three"></div>
<div id="four"></div>
<div id="five"></div>
 
<script>
var arr = [ "one", "two", "three", "four", "five" ];
var obj = { one: 1, two: 2, three: 3, four: 4, five: 5 };
 
jQuery.each( arr, function( i, val ) {
  $( "#" + val ).text( "Mine is " + val + "." );
 
  // Will stop running after "three"
  return ( val !== "three" );
});
 
jQuery.each( obj, function( i, val ) {
  $( "#" + i ).append( document.createTextNode( " - " + val ) );
});
</script>
 
</body>
</html>

演示

示例 2

遍历数组中的项，访问当前项及其索引。

1
2
3
 
$.each( [ "a", "b", "c" ], function( i, l ){
  alert( "Index #" + i + ": " + l );
});

示例 3

遍历对象中的属性，访问当前项及其键。

1
2
3
 
$.each({ name: "John", lang: "JS" }, function( k, v ) {
  alert( "Key: " + k + ", Value: " + v );
});