each() 會把匹配集合中的每一個元素輪流作為上下文,執行你提供的函式。每次執行時,元素在集合中的索引會被傳進來,索引從 0 起算。
回呼函式的回傳值控制著迴圈走向:回傳 false 會立刻中止整個迴圈,回傳 true 則繼續下一輪(等同預設行為)。這個設計讓「找到目標就停」變得很直接。
兩者名稱相近但適用範圍不同:$(selector).each() 只能遍歷 jQuery 物件;而 jQuery.each(object, fn) 可以遍歷任何陣列或純物件。選擇依據在於你手上的資料是什麼型別。
$(selector).each(function(index, element))
index 是當前元素在集合中的索引,element 是當前的原生 DOM 元素(也可以直接用 this 代表它)。注意 element 是原生節點,若要呼叫 jQuery 方法需先包成 $(element)。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>each() 方法</title>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("#btn").click(function(){
$("li").each(function(index, element){
alert($(element).text());
});
});
});
</script>
</head>
<body>
<ul>
<li>後台專區</li>
<li>前台專區</li>
<li>數據庫專區</li>
<li>站長專區</li>
</ul>
<button id="btn">點擊查看效果</button>
</body>
</html>
點擊按鈕會依序彈出四段文字,也就是每個 li 的內容。
$("li").each(function(index, element){
if ($(element).text() === "數據庫專區") {
return false; // 找到就停止,後面的項目不再處理
}
console.log(index, $(element).text());
});
另一個常見需求是累加索引做序號顯示:
$("li").each(function(i){
$(this).text((i + 1) + ". " + $(this).text());
});
最後提醒效能觀念:迴圈內每次都重新呼叫 $() 包裝會產生額外開銷。若迴圈很長且操作單純(例如只讀取原生屬性),直接使用 element 會更快;另外,若只是想做集合轉換,.map() 往往比 each() 加手動組陣列更直觀。