jQuery.each()


jQuery.each( collection, callback(indexInArray, valueOfElement) )返回: Object

描述: 一个通用的迭代函数,它可以用来无缝迭代对象和数组。数组和类似数组的对象通过一个长度属性(如一个函数的参数对象)来迭代数字索引,从0到length - 1。其他对象通过其属性名进行迭代。

  • 添加的版本: 1.0jQuery.each(array, callback )

    • array
      类型: Array
      遍历的数组。
    • callback
      类型: Function( Integer indexInArray, Object value )
      该函数会在每个对象上(迭代)调用。
  • 添加的版本: 1.0jQuery.each( object, callback )

    • object
      类型: Object
      遍历的对象。
    • callback
      类型: Function( String propertyName, Object valueOfProperty )
      该函数会在每个对象上(迭代)调用。

$.each()函数和 $(selector).each()是不一样的,那个是专门用来遍历一个jQuery对象。$.each()函数可用于迭代任何集合,无论是“名/值”对象(JavaScript对象)或数组。在迭代数组的情况下,回调函数每次传递一个数组索引和相应的数组值作为参数。(该值也可以通过访问this关键字得到,但是JavaScript将始终将this值作为一个Object ,即使它是一个简单的字符串或数字值。)该方法返回其第一个参数,这是迭代的对象。

注意: $.each()函数会在内部检索并且使用传递集合的 length属性。 所以,如果集合有一个名为length的属性 - 比如 {bar: 'foo', length: 10} - 这个函数可能无法正常工作。

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

我们可以在$.each()返回false来终止迭代。返回非false相当于一个循环中的continue语句,这意味着,它会立即跳出当前的迭代,转到下一个迭代。

例子:

Example: 对数组进行迭代,迭代过程中同时显示关键字及数值

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="http://code.jquery.com/jquery-1.9.1.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>

Demo:

Example: 迭代一个数组,并同时访问迭代的元素及它的索引值。

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

Example: 在一个元素的属性上进行迭代,并同时访问它的键及值。

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