each() 是 jQuery 裡最常被使用的遍歷方法,但它的能力常被低估。以下用五個由淺入深的例子看它能做什麼。
<ul class="one">
<li>11a</li><li>22b</li><li>33c</li><li>44d</li><li>55e</li>
</ul>
<button>輸出每個 li 值</button>
<script>
$("button").click(function () {
$(".one > li").each(function () {
console.log($(this).text());
});
});
</script>
each 的 callbacks 帶有 index 參數,而 $(this) 指向當前元素,兩者搭配就能為每個 li 獨立綁定行為:
<ul class="two">
<li>2222</li><li>22b</li><li>3333</li><li>44d</li><li>5555</li>
</ul>
<script>
$('.two > li').each(function (index) {
console.log(index + ":" + $(this).text());
$(this).click(function () {
alert($(this).text());
$(this).css("background", "#fe4365");
});
});
</script>
<ul class="ctn3"><li>Eat</li><li>Sleep</li><li>3種</li></ul>
<span>點擊3</span>
<script>
$('span').click(function () {
$('.ctn3 > li').each(function () {
$(this).toggleClass('example');
});
});
</script>
each 的 callback 簽名是 function(index, element),其中 element 是原生 DOM 元素,包成 jQuery 物件後就等於 $(this)。下面這個例子示範了如何用 return false 提早中止迴圈:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>each 練習2</title>
<style>
div {
width: 40px; height: 40px; margin: 5px; float: left;
border: 2px blue solid; text-align: center;
}
span { width: 40px; height: 40px; color: red; }
</style>
</head>
<body>
<div></div><div></div><div></div>
<div id="stop">Stop here</div>
<div></div><div></div>
<button>Change colors</button>
<span></span>
<script src="jquery-1.11.1.min.js"></script>
<script>
$('button').click(function () {
$('div').each(function (index, element) {
// element == this
$(element).css("background", "yellow");
if ($(this).is("#stop")) {
$('span').text("index :" + index);
return false; // 中止整個 each 迴圈
}
});
});
</script>
</body>
</html>
這裡有個實務上很關鍵的規則:在 each 中 return false 等於 break,return 其他值等於 continue。很多效能問題就出在該 break 的地方寫成了 continue,導致後續元素仍被逐一處理。
另外值得一提的是 $.each() 與 .each() 的區別:前者是通用工具函式,可遍歷陣列與物件;後者是 jQuery 集合的方法,只能遍歷選取到的元素集合。兩者的 callback 參數順序也相反——$.each(obj, function(key, value)) 是「索引在前」,而 jQuery 物件的方法一樣是索引在前,這點容易搞混,值得記住。