三種 each() 形式對比
| 形式 | 語法 | 適用對象 | 回調參數 | this 指向 |
| $.each() (靜態方法) | $.each(collection, callback) | 陣列、物件、類陣列 | (index, value) | value (原始值) |
| .each() (實例方法) | $collection.each(callback) | jQuery 物件 (DOM 集合) | (index, element) | element (DOM 元素) |
| .each() 隱式迴圈 | 多數 setter 方法內建 | jQuery 物件 | - | - |
完整互動範例
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery each() 遍歷示範</title>
<style>
.container { max-width: 700px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
.demo-section { margin: 20px 0; padding: 20px; border: 1px solid #e0e0e0; border-radius: 8px; }
.demo-section h3 { margin-top: 0; color: #1976d2; }
.code { background: #263238; color: #aed581; padding: 12px; border-radius: 4px; font-family: monospace; font-size: 13px; white-space: pre-wrap; overflow-x: auto; }
button { padding: 8px 16px; margin: 5px; background: #1976d2; color: white; border: none; border-radius: 4px; cursor: pointer; }
button.secondary { background: #757575; }
.output { background: #f5f5f5; padding: 12px; border-radius: 4px; font-family: monospace; min-height: 60px; white-space: pre-wrap; }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<div class="container">
<h2>jQuery each() 三大用法互動示範</h2>
<div class="demo-section">
<h3>1. $.each() 遍歷陣列</h3>
<button id="btnEachArray">遍歷陣列 [10,20,30]</button>
<button id="btnEachArrayBreak" class="secondary">遍歷並中斷 (index>1)</button>
<div class="output" id="out1"></div>
</div>
<div class="demo-section">
<h3>2. $.each() 遍歷物件 (JSON)</h3>
<button id="btnEachObj">遍歷 {name:'Alice', age:25, city:'Taipei'}</button>
<div class="output" id="out2"></div>
</div>
<div class="demo-section">
<h3>3. $().each() 遍歷 jQuery 集合</h3>
<ul id="demoList">
<li data-id="1">蘋果</li>
<li data-id="2">香蕉</li>
<li data-id="3">橘子</li>
</ul>
<button id="btnEachJQ">遍歷 li 集合</button>
<button id="btnEachJQBreak" class="secondary">遍歷並中斷 (id=2)</button>
<div class="output" id="out3"></div>
</div>
</div>
<script>
$(function() {
// 1. 陣列遍歷
$('#btnEachArray').on('click', () => {
const arr = [10, 20, 30];
let out = '';
$.each(arr, (i, val) => {
out += `索引 ${i}: ${val}\n`;
});
$('#out1').text(out);
});
$('#btnEachArrayBreak').on('click', () => {
const arr = [10, 20, 30];
let out = '';
$.each(arr, (i, val) => {
if (i > 1) return false; // 中斷迴圈 (相當於 break)
out += `索引 ${i}: ${val}\n`;
});
$('#out1').text(out + '--- 已中斷 ---');
});
// 2. 物件遍歷
$('#btnEachObj').on('click', () => {
const obj = {name: 'Alice', age: 25, city: 'Taipei'};
let out = '';
$.each(obj, (key, val) => {
out += `${key}: ${val}\n`;
});
$('#out2').text(out);
});
// 3. jQuery 集合遍歷
$('#btnEachJQ').on('click', () => {
let out = '';
$('#demoList li').each((i, el) => {
const $el = $(el);
out += `[${i}] ID: ${$el.data('id')}, 文字: ${$el.text()}, this.tagName: ${el.tagName}\n`;
});
$('#out3').text(out);
});
$('#btnEachJQBreak').on('click', () => {
let out = '';
$('#demoList li').each((i, el) => {
if ($(el).data('id') === 2) return false; // 中斷
out += `[${i}] ${$(el).text()}\n`;
});
$('#out3').text(out + '--- 在 id=2 處中斷 ---');
});
});
</script>
</body>
</html>
核心細節深度解析
1. 中斷迴圈:return false = break,return true = continue
$.each(arr, (i, val) => {
if (val === 20) return false; // 終止整個 each (break)
if (val === 10) return true; // 跳過本次迴圈 (continue)
console.log(val);
});
這與原生 forEach 無法中斷形成鮮明對比。
2. this 指向差異
| 方法 | this 指向 | 取值方式 |
$.each(obj, fn) | value (原始值:字串/數字/物件) | this 直接是值 |
$collection.each(fn) | DOM 元素 (原生 element) | this.tagName, $(this).data() |
// 物件遍歷:this 是值 (基本類型會被包裝為包裝物件)
$.each({a:1}, function() { console.log(this); }); // Number {1}
// jQuery 集合:this 是 DOM 元素
$('#list li').each(function() { console.log(this); }); // ...
3. 陣列 vs 類陣列 vs 物件
// 陣列:按索引順序 0,1,2...
$.each([10,20], fn); // i=0,1
// 類陣列 (arguments, NodeList):按索引順序
$.each(document.querySelectorAll('div'), fn); // i=0,1...
// 物件:按鍵名順序 (現代瀏覽器保持插入順序)
$.each({b:1, a:2}, fn); // key='b', key='a'
4. 隱式 each:Setter 方法自動遍歷
// 這些方法內部自動 each,無需手寫迴圈
$('div').css('color', 'red'); // 為所有 div 設置顏色
$('input').val('test'); // 為所有 input 設置值
$('.item').addClass('active'); // 為所有 .item 添加類別
$('img').attr('src', 'new.jpg'); // 為所有 img 設置 src
進階模式與最佳實踐
1. 陣列轉換:.map() vs .each()
// 需要返回新陣列用 .map()
const doubled = $numbers.map((i, el) => parseInt(el.value) * 2).get();
// 只需副作用 (副作用:修改 DOM、發請求、日誌) 用 .each()
$items.each((i, el) => {
$(el).addClass('processed');
saveToServer($(el).data('id'));
});
2. 非同步迴圈:each 不支援 await
// ❌ 錯誤:each 不會等待 async 函數
$.each(items, async (i, item) => {
await api.save(item); // 併發執行,順序不可控
});
// ✅ 正確:for...of 配合 await
for (const item of items) {
await api.save(item); // 依序執行
}
// 或用 Promise.all 併發
await Promise.all(items.map(item => api.save(item)));
3. 效能:原生 for 迴圈 vs $.each()
// 大量資料 (10萬+) 時,原生 for 快 10-50 倍
for (let i = 0, len = arr.length; i < len; i++) { ... }
// 現代語法也很快
for (const item of arr) { ... }
arr.forEach((item, i) => { ... }); // 無法中斷
避坑指南
⚠ 常見錯誤:
- 在
$.each(object) 中用 this.key 取鍵名 → this 是值,無 key 屬性,需用參數 key
- 在
$().each() 中用 this.id 取 ID → this 是 DOM,直接 this.id 正確
- 以為
return true 會返回結果 → 實為 continue,each() 返回原集合,無法自定義返回值
- 箭頭函數中用
this → 箭頭函數無 this,必須用參數 (i, el) => ...
總結
$.each(collection, fn):通用遍歷陣列/物件,this=value,支援 return false 中斷
$collection.each(fn):遍歷 jQuery 集合,this=DOM 元素,支援中斷
- Setter 方法 (
.css(), .val(), .attr()...) 內建隱式 each
- 大量資料/非同步場景優先用原生
for...of / forEach / map
- 記住 return false = break, return true = continue