JQuery提供了一个对象遍历的Utility方法$.each()和一个JQuery集合遍历方法.each()。
$.each()是一个通用的方法用来遍历对象和数组，Plain对象是通过其命名属性进行遍历的。
$.each()可以用来替换传统的for和for-in循环。
var sum = 0;
var arr = [ 1, 2, 3, 4, 5 ];
for ( var i = 0, l = arr.length; i < l; i++ ) {
sum += arr[ i ];
}
console.log( sum ); // 15
$.each( arr, function( index, value ){
sum += value;
});
console.log( sum ); // 15
|
需要注意的是我们不需要通过arr[ index ]来访问$.each()迭代的值。
var sum = 0;
var obj = {
foo: 1,
bar: 2
}
for (var item in obj) {
sum += obj[ item ];
}
console.log( sum ); // 3
$.each( obj, function( key, value ) {
sum += value;
});
console.log( sum ); // 3
|
需要注意的是$.each()可以用来迭代plain对象,、数组和非JQuery集合的类数组对象，JQuery集合需要使用.each()。
// 以下代码是错误的
$.each( $( "p" ), function() {});
|
.each()是直接使用在JQuery集合上的，它遍历集合中匹配的元素并执行回调函数，当前元素的序号作为回调函数的第一个参数，如果是DOM元素的话也将被传递作为第二个参数。在回调函数中也可以使用this关键字指向当前元素。
<ul>
<li><a href="#">Link 1</a></li>
<li><a href="#">Link 2</a></li>
<li><a href="#">Link 3</a></li>
</ul>
$( "li" ).each( function( index, element ){
console.log( $( this ).text() );
});
// Link 1
// Link 2
// Link 3
|
无论是故意的还是不经意的，执行上下文有可能会发生改变。当经常使用this关键字时，很容易混淆自己或别人编写的代码。即使执行上下文保持不变，它也更具有可读性。
$( "li" ).each( function( index, listItem ) {
this === listItem; // true
$.ajax({
success: function( data ) {
// 上下文发生改变了
this !== listItem; // true
}
});
});
|
许多JQuery方法都隐含遍历，他们将应用在每个匹配的元素上。例如：
$( "li" ).each( function( index, el ) {
$( el ).addClass( "newClass" );
});
$( "li" ).addClass( "newClass" );
|
也有一些方法是不能进行遍历的，这时就需要 .each()的帮助了。例如：
// 无法运行的
$( "input" ).val( $( this ).val() + "%" );
// .val() 不能改变执行上下文，所以这里this === window
$( "input" ).each( function( i, el ) {
var elem = $( el );
elem.val( elem.val() + "%" );
});
|
以下的方法是需要 .each()进行迭代的：
- .attr() (getter)
- .css() (getter)
- .data() (getter)
- .height() (getter)
- .html() (getter)
- .innerHeight()
- .innerWidth()
- .offset() (getter)
- .outerHeight()
- .outerWidth()
- .position()
- .prop() (getter)
- .scrollLeft() (getter)
- .scrollTop() (getter)
- .val() (getter)
- .width() (getter)
需要注意的是大部分情况下，getter返回的结果是JQuery集合中的第一个元素，而setter的行为影响集合中所有匹配的元素。
此外，一个setter的值、特性、属性、CSS的setter和一个接受匿名回调函数的DOM插入方法（.text() and .html()）是被应用到每一个匹配的元素，传递给回调函数的参数是当前匹配元素的序号。
$( "input" ).each( function( i, el ) {
var elem = $( el );
elem.val( elem.val() + "%" );
});
$( "input" ).val(function( index, value ) {
return value + "%";
});
|
无论什么时候，当我们想创建一个数组或基于所匹配的元素串联字符串，我们可以使用.map()更好的进行遍历。
var newArr = [];
$( "li" ).each( function() {
newArr.push( this.id );
});
$( "li" ).map( function(index, element) {
return this.id;
}).get();
|
需要注意的是，.get()连接在最后面，.map()返回的是一个JQuery包裹集合，即使回调函数返回的是字符串。.get()返回的是一个基本的JavaScript数组。如果想要拼接字符串，可以在数组方法.get()之后连接原生JavaScript方法 .join()。
$.map()运行在原生JavaScript数组上，而.map()运行在JQuery元素集合上。$.map()返回的是一个原生JavaScript数组并且不需要使用.get()方法。
<li ></li>
<li ></li>
<li ></li>
<script>
var arr = [{
id: "a",
tagName: "li"
}, {
id: "b",
tagName: "li"
}, {
id: "c",
tagName: "li"
}];
// 返回 [ "a", "b", "c" ]
$( "li" ).map( function( index, element ) {
return element.id;
}).get();
// 返回 ["a", "b", "c"]
$.map( arr, function( value, index ) {
return value.id;
});
</script>
|