jQuery.each( collection, callback(indexInArray, valueOfElement) )返回: Object
描述: 一个通用的迭代函数,它可以用来无缝迭代对象和数组。数组和类似数组的对象通过一个长度属性(如一个函数的参数对象)来迭代数字索引,从0到length - 1。其他对象通过其属性名进行迭代。
-
添加的版本: 1.0jQuery.each(array, callback )
-
array类型: Array遍历的数组。
-
callback该函数会在每个对象上(迭代)调用。
-
-
添加的版本: 1.0jQuery.each( object, callback )
-
object类型: Object遍历的对象。
-
callback该函数会在每个对象上(迭代)调用。
-
$.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
语句,这意味着,它会立即跳出当前的迭代,转到下一个迭代。
ps:文档上说 return false 相当于循环中的continue语句,但实际测试发现它更类似于break,跳出当前循环。
<!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>
结果:
Mine is one.
Mine is two.
Mine is three.
- 2- 1
例子2:- 3 - 4 - 5
例子3:$.each( ['a','b','c'], function(i, l){ alert( "Index #" + i + ": " + l ); });
$.each( { name: "John", lang: "JS" }, function(k, v){ alert( "Key: " + k + ", Value: " + v ); });