DIV CSS 佈局教程網

jQuery each 詳解:遍歷陣列、物件與 DOM 集合的兩種形式
編輯:JQuery特效代碼     

each() 是 jQuery 裡最常被使用、也最常被誤用的工具方法。它有兩種形式,作用對象不同,語意也不同,分清楚之後很多程式碼都能寫得更乾淨。

形式一:$().each()——遍歷 jQuery 集合

回呼函式接收兩個參數:第一個是索引,第二個是該位置的 DOM 元素。要中止迴圈,讓回呼 return false。

從 option 開始遍歷

計劃類別:
<select id="PLANTYPE">
  <option value="0">-所有-</option>
  <option value="1">新建</option>
  <option value="2">續建</option>
</select>

申報類型:
<select id="AUDITTYPE">
  <option value="0">-所有-</option>
  <option value="1">申報</option>
  <option value="2">修改</option>
</select>
$("option").each(function (index, data) {
    console.info($(data).text());    // 亦可寫 $(this).text()
});

注意回呼裡的 this 與第二個參數 data 指向同一個 DOM 元素,兩者等效。用哪個純屬風格偏好,但 jQuery 官方文件建議在函式內部一律使用 $(this) 以便閱讀。

從 select 開始,巢狀遍歷

$("select").each(function (index, data) {
    $("option", data).each(function (m, n) {
        console.info($(this).text());
    });
});

關鍵在 $("option", data) 的第二個參數。少了它,你會拿到全頁所有的 option,而不是當前 select 底下那些。這是最常見的 bug 來源,養成習慣永遠帶上上下文。

形式二:$.each()——遍歷任何物件或陣列

與 $().each() 不同,這個是掛在 jQuery 命名空間上的靜態方法,可以走訪任何陣列或物件,不限於 DOM。

// 遍歷 jQuery 物件
$.each($("option"), function (index, data) {
    console.info(index + " " + data);
});

// 遍歷陣列
$.each([0, 1, 2], function (i, n) {
    console.info("Index:" + i + ":" + n);
});

// 遍歷物件
$.each({ name: "itmyhome", addr: "Beijing" }, function (i, n) {
    console.info("Name: " + i + ", Value: " + n);
});

同樣地,return false 可提早結束;return 不帶值則等同 continue,跳到下一輪。

該用哪一個?

  • 要操作 DOM 集合,用 $().each()。它保留了鏈式呼叫的能力,可以 $("li").each(...).addClass("done")。
  • 要處理純資料(陣列、物件、後端回傳的 JSON),用 $.each()。
  • 兩者都能提前跳出,但只有 $().each() 回傳 jQuery 物件,能繼續串接。

現代寫法對照

ES5 之後,原生迭代方法在大多數情境下更直觀:

// 陣列
[0, 1, 2].forEach(function (n, i) {
    console.info("Index:" + i + ":" + n);
});

// DOM 集合(NodeList 自 2015 起也支援 forEach)
document.querySelectorAll("option").forEach(function (el) {
    console.info(el.textContent);
});

// 物件
Object.keys({ name: "itmyhome", addr: "Beijing" }).forEach(function (k) {
    console.info("Name: " + k + ", Value: " + obj[k]);
});

// 需要 break 時用 for...of
for (const el of document.querySelectorAll("li")) {
    if (el.dataset.done) { break; }
}

forEach 無法 break(只能用 some/every 或 throw 來模擬),這是需要提前結束時改用 for...of 的主要理由。另外 $.each() 能遍歷類陣列物件(如 arguments)與一般物件,這點 forEach 做不到,是它仍有價值的地方。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved