each() 是 jQuery 裡最常被使用、也最常被誤用的工具方法。它有兩種形式,作用對象不同,語意也不同,分清楚之後很多程式碼都能寫得更乾淨。
回呼函式接收兩個參數:第一個是索引,第二個是該位置的 DOM 元素。要中止迴圈,讓回呼 return false。
計劃類別: <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").each(function (index, data) {
$("option", data).each(function (m, n) {
console.info($(this).text());
});
});
關鍵在 $("option", data) 的第二個參數。少了它,你會拿到全頁所有的 option,而不是當前 select 底下那些。這是最常見的 bug 來源,養成習慣永遠帶上上下文。
與 $().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,跳到下一輪。
$().each()。它保留了鏈式呼叫的能力,可以 $("li").each(...).addClass("done")。$.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 做不到,是它仍有價值的地方。