| 方法 | 簽名 | 用途 | 回調參數 |
|---|---|---|---|
$.each(collection, callback) | 靜態工具方法 | 遍歷**任意**陣列、類陣列、對象 | callback(index/key, value) |
$(selector).each(callback) | 實例方法 | 遍歷 **jQuery 對象集合**(DOM 元素) | callback(index, domElement) |
// 陣列
$.each([1,2,3], function(i, val) { console.log(i, val); });
// 0 1
// 1 2
// 2 3
// 對象
$.each({a:1, b:2}, function(key, val) { console.log(key, val); });
// a 1
// b 2
// 類陣列(arguments、NodeList)
$.each(document.querySelectorAll('div'), function(i, el) { ... });
// 提前終止:return false 相當 break;return true 相當 continue
$.each(arr, function(i, v) {
if (v === 3) return false; // 跳出循環
if (v === 2) return true; // 跳過本次
});
$('.items').each(function(index, element) {
// this === element (原生 DOM)
// $(this) 可轉為 jQuery 對象
console.log(index, this.tagName, this.className);
});
// 鏈式調用
$('.items').each(function() {
$(this).addClass('processed');
}).filter('.active').hide();
$.each 回調內 this 指向 value(基本類型則為包裝對象);$().each 回調內 this 指向原生 DOM 元素。$.each 是 (key, value);$().each 是 (index, element)。$.each 通用;$().each 僅限 jQuery 對象。$.each 略快(無 jQuery 包裝開銷),但差異微乎其微。// ❌ 錯誤:試圖用 $().each 遍歷普通對象
var obj = {a:1, b:2};
$(obj).each(function(k, v) { ... }); // 無效,jQuery 不會包裝普通對象
// ✅ 正確
$.each(obj, function(k, v) { ... });
// ❌ 錯誤:在 $.each 回調中用 $(this) 以為是 jQuery 對象
$.each([1,2], function(i, v) {
console.log($(this)); // 數字被包裝為 Number 對象,非 DOM
});
// 陣列
arr.forEach((v, i) => ...);
arr.map(v => ...);
arr.filter(v => ...);
// 對象
Object.entries(obj).forEach(([k, v]) => ...);
Object.keys(obj).forEach(k => ...);
// NodeList
nodeList.forEach((el, i) => ...); // 現代瀏覽器支援
// 或 Array.from(nodeList).forEach(...)
新項目優先使用原生方法,減少 jQuery 依賴;存量項目清晰區分兩者用法,避免上下文混淆導致 Bug。