jQuery.each()

所属分类：工具类 英文文档：jQuery.each()

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

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

  • 添加的版本: 1.0jQuery.each( collection, callback(indexInArray, valueOfElement) )

    • collection
      类型: Object
      遍历的对象或数组。
    • callback(indexInArray, valueOfElement)
      类型: Function()
      该函数会在每次迭代时被调用。

$.each()函数和 $(selector).each()是不一样的，那个是专门用来遍历一个jQuery对象。$.each()函数可用于迭代任何集合，无论是“名/值”对象（JavaScript对象）或数组。在迭代数组的情况下，回调函数每次传递一个数组索引和相应的数组值作为参数。（该值也可以通过访问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

我们可以在$.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="https://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 );
 });