概述 jQuery.each( collection, callback(indexInArray, valueOfElement) )
返回值:Object
描述: 一个通用的迭代函数,它可以用来无缝迭代对象和数组。数组和类似数组的对象通过一个长度属性(如一个函数的参数对象)来迭代数字索引,从0到length - 1。其他对象通过其属性名进行迭代。
$.each()
函数和 $(selector).each()是不一样的,那个是专门用来遍历一个jQuery对象。$.each()
函数可用于迭代任何集合,无论是“名/值”对象(JavaScript对象)或数组。在迭代数组的情况下,回调函数每次传递一个数组索引和相应的数组值作为参数。(该值也可以通过访问this
关键字得到,但是JavaScript将始终将this
值作为一个Object
,即使它是一个简单的字符串或数字值。)该方法返回其第一个参数,这是迭代的对象。
注意: $.each()
函数会在内部检索并且使用传递集合的 length
属性。
所以,如果集合有一个名为length
的属性 - 比如 {bar: 'foo', length: 10}
- 这个函数可能无法正常工作。
$.each([52, 97], function(index, value) {
alert(index + ': ' + value);
});
这将产生两个信息:
0: 52
1: 97
如果对象是作为集合使用,回调函数每次传递一个键值对的:
var obj = {
"flammable": "inflammable",
"duh": "no duh"
};
$.each( obj, function( key, value ) {
alert( key + ": " + value );
});
再次,这将产生两个信息:
flammable: inflammable
duh: no duh
我们可以在$.each()
返回false
来终止迭代。返回非false相当于一个循环中的continue
语句,这意味着,它会立即跳出当前的迭代,转到下一个迭代。
示例
对数组进行迭代,迭代过程中同时显示关键字及数值
<!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>运行一下
迭代一个数组,并同时访问迭代的元素及它的索引值。
$.each( ['a','b','c'], function(i, l){ alert( "Index #" + i + ": " + l ); });
在一个元素的属性上进行迭代,并同时访问它的键及值。
$.each( { name: "John", lang: "JS" }, function(k, v){ alert( "Key: " + k + ", Value: " + v ); });