each() 是 jQuery 裡最常被使用的遍歷工具。它把大量 for 迴圈與狀態維護收進一個函式,讓 DOM 迴圈結構變得簡潔,也不容易寫錯邊界條件。不論是一維陣列、多維陣列、JSON 物件還是 DOM 集合,都能用同一套寫法處理。
var arr1 = ["aaa", "bbb", "ccc"];
$.each(arr1, function (i, val) {
alert(i); // 0、1、2
alert(val); // aaa、bbb、ccc
});
回呼函式的第一個參數是索引,第二個是值。
var arr2 = [['a', 'aa', 'aaa'], ['b', 'bb', 'bbb'], ['c', 'cc', 'ccc']];
$.each(arr2, function (i, item) {
alert(i); // 0、1、2
alert(item); // ['a','aa','aaa'] 這類子陣列
});
此時 item 拿到的是每一列的陣列,用 item[0] 才能取到該列的第一個值。若要展平所有元素,就巢狀呼叫:
$.each(arr2, function (i, item) {
$.each(item, function (j, val) {
alert(j); // 0,1,2, 0,1,2, 0,1,2
alert(val); // a,aa,aaa, b,bb,bbb, c,cc,ccc
});
});
var obj = { one: 1, two: 2, three: 3 };
$.each(obj, function (key, val) {
alert(key); // one、two、three
alert(val); // 1、2、3
});
這裡的第一個參數不是數字索引,而是屬性名稱。原因很直覺:JSON 的成員是無序的鍵值對,既然沒有順序,自然也不存在索引。而 val 等同於 obj[key]。
<input name="aaa" type="hidden" value="111" />
<input name="bbb" type="hidden" value="222" />
<input name="ccc" type="hidden" value="333" />
<input name="ddd" type="hidden" value="444" />
$.each($("input:hidden"), function (i, val) {
alert(val); // [object HTMLInputElement]
alert(i); // 0、1、2、3
alert(val.name); // aaa、bbb、ccc、ddd
alert(val.value); // 111、222、333、444
});
也可以改用 jQuery 集合自身的 each():
$("input:hidden").each(function (i, val) {
alert(i);
alert(val.name);
alert(val.value);
});
兩種寫法輸出一致。差別在於:一把 jQuery 物件當參數交給 $.each,是把集合當資料處理;另一把則是以集合的方法形式呼叫,jQuery 內部其實只是把自身作為第一個參數轉交給 $.each,本質相同。另外,在回呼函式中 this 會指向目前元素,所以 this.name 與 val.name 效果一樣。
function (object, callback, args) {
var name, i = 0, length = object.length;
if (args) {
if (length == undefined) {
for (name in object) {
if (callback.apply(object[name], args) === false) break;
}
} else {
for (; i < length;) {
if (callback.apply(object[i++], args) === false) break;
}
}
} else {
if (length == undefined) {
for (name in object) {
if (callback.call(object[name], name, object[name]) === false) break;
}
} else {
for (var value = object[0]; i < length &&
callback.call(value, i, value) !== false; value = object[++i]) {}
}
}
return object;
}
關鍵在 length == undefined 這個判斷:
for...in,回呼收到「屬性名、屬性值」。而 callback.call(value, i, value) 這一行同時完成兩件事:把 this 指向 value,並送進索引與元素兩個參數。這正是 $("...").each(function (index, elem) { ... }) 能成立的機制。
這是 each() 與原生迴圈最大的行為差異,值得單獨記住:
false,等同 break,立刻中止整個遍歷。true 或不返回值,等同 continue,繼續下一輪。$.each([1, 2, 3, 4, 5], function (i, n) {
if (n === 3) return false; // 遇到 3 就停止
alert(n); // 只印出 1、2
});
實作細節上還有一個容易被忽略的差異:
false 就跳出,因此中斷是有效的。for...in 分支,回傳值不參與迴圈條件判斷,所有屬性都會被走過一次。所以「遇到條件就停」這個技巧,只在陣列與 jQuery 集合上可靠。針對純物件時,建議改用內部條件判斷來跳過後續處理,別依賴 return false。
each() 的強大來自一個簡潔的設計:用「有沒有 length」判斷資料形態,再決定走索引迴圈還是屬性迴圈。理解這一點,加上「return false 就是 break」的約定,你就能在任何資料結構上自由操作。