萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery `$.each` 通用遍歷:陣列、物件、DOM、jQuery 物件、巢狀結構完整用法

統一簽名

$.each(collection, function(index, value) {
  // this === value (原始值會被包裝成 Object)
  // 返回 false → 終止迴圈 (break)
  // 返回 true  → 跳過本次 (continue)
});

五大數據類型遍歷示範

1. 一維陣列

const arr = ['one', 'two', 'three'];
$.each(arr, (i, val) => console.log(i, val));
// 0 "one"
// 1 "two"
// 2 "three"

2. 物件 (Plain Object)

const obj = { a: 1, b: 2, c: 3 };
$.each(obj, (key, val) => console.log(key, val));
// "a" 1
// "b" 2
// "c" 3

3. DOM 節點列表 / HTMLCollection

$.each(document.querySelectorAll('li'), (i, el) => {
  console.log(i, el.textContent);
  // this === el (HTMLLIElement)
});

4. jQuery 物件 (內部已是類陣列)

$('.item').each((i, el) => {
  // 等價於 $('.item').each(fn)
  // this === el (原生 DOM)
  $(el).addClass(`item-${i}`);
});

5. 多維陣列 / 巢狀結構

const matrix = [[1,2,3], [4,5,6], [7,8,9]];
$.each(matrix, (rowIdx, row) => {
  $.each(row, (colIdx, val) => {
    console.log(`[${rowIdx},${colIdx}] = ${val}`);
  });
});
// 輸出 [0,0]=1 [0,1]=2 ... [2,2]=9

進階控制流

$.each([1,2,3,4,5], (i, v) => {
  if (v === 3) return false; // break 整個迴圈
  if (v % 2 === 0) return true; // continue 跳過偶數
  console.log(v); // 只印 1
});

效能與現代替代方案

場景推薦寫法理由
陣列遍歷`arr.forEach(fn)` / `for...of`原生、無函數調用開銷、支援 `break`/`continue` (for...of)
物件遍歷`Object.entries(obj).forEach(([k,v])=>...)`標準、可解構、TypeScript 友善
DOM 節點列表`[...nodes].forEach(fn)` 或 `Array.from(nodes).forEach(fn)`轉真陣列後用原生方法
jQuery 物件`$els.each(fn)` (實例方法)內部優化、鏈式調用、語意明確
需中途終止`for...of` + `break``.each` 返回 `false` 語意不直觀

TypeScript 類型提示

// $.each 類型定義 (DefinitelyTyped)
interface JQueryStatic {
  each(collection: T[], callback: (index: number, value: T) => boolean | void): T[];
  each(collection: Record, callback: (key: string, value: T) => boolean | void): Record;
  each(collection: ArrayLike, callback: (index: number, value: T) => boolean | void): ArrayLike;
}

結語

`.each()` 是 jQuery 時代統一遍歷介面的產物。現代開發**陣列用 `forEach`/`for...of`、物件用 `Object.entries`、DOM 列表用 `Array.from`**,只有在 **jQuery 物件鏈式調用中** 才繼續用 `$().each()`。理解「回傳 `false` = break、`true` = continue」特殊語意,維護舊代碼時不會踩坑。

copyright © 萬盛學電腦網 all rights reserved