| 方法 | 用途 | 回調參數 | 返回值 |
|---|---|---|---|
$.each(collection, callback) | 遍歷任意集合(數組/對象/類數組) | (index, value),this === value | 原集合(鏈式調用無意義) |
$(selector).each(callback) | 遍歷 jQuery 對象(DOM 元素集合) | (index, element),this === element | jQuery 對象(可鏈式) |
var arr = ['aaa', 'bbb', 'ccc'];
$.each(arr, function(i, val) {
console.log(i, val); // 0 aaa, 1 bbb, 2 ccc
// this === val (基本類型會被包裝為對象)
});
var matrix = [['a','aa','aaa'], ['b','bb','bbb'], ['c','cc','ccc']];
// 只遍歷第一層
$.each(matrix, function(i, row) {
console.log(i, row); // 0 ['a','aa','aaa'] ...
});
// 遞歸遍歷所有層
function deepEach(arr, fn, depth) {
depth = depth || 0;
$.each(arr, function(i, val) {
if ($.isArray(val)) deepEach(val, fn, depth+1);
else fn.call(val, i, val, depth);
});
}
deepEach(matrix, function(i, val, d) {
console.log(' '.repeat(d) + i + ': ' + val);
});
var obj = { one: 1, two: 2, three: 3 };
$.each(obj, function(key, val) {
console.log(key, val); // one 1, two 2, three 3
// this === val
// key 是字符串屬性名,非數字索引
});
對象屬性無序(ES2015+ 保持插入序),故無數字索引。
<input type="hidden" name="a" value="1">
<input type="hidden" name="b" value="2">
$.each($('input:hidden'), function(i, el) {
console.log(i, el.name, el.value); // 0 a 1, 1 b 2
// el 是原生 DOM,this === el
// $(this).val() 等同 el.value
});
// 等價寫法(返回 jQuery 對象可鏈式)
$('input:hidden').each(function(i, el) { /* ... */ });
function each(obj, callback, args) {
var isArray = obj.length !== undefined; // 類數組判斷
var i = 0, len = obj.length;
if (args) { // 內部用,傳額外參數給 callback
if (isArray) { for (; i < len; i++) if (callback.apply(obj[i], args) === false) break; }
else { for (var k in obj) if (callback.apply(obj[k], args) === false) break; }
} else {
if (isArray) {
for (var val = obj[0]; i < len && callback.call(val, i, val) !== false; val = obj[++i]) {}
} else {
for (var k in obj) if (callback.call(obj[k], k, obj[k]) === false) break;
}
}
return obj;
}
關鍵點:
callback.call(val, i, val) 綁定 this 為當前值false 可中斷循環(類似 break)true 可跳過本次(類似 continue)for/for...of/Array.prototype.forEach 更快,$.each 有函數調用開銷。return false(break),return true(continue)。// 數組
arr.forEach((val, i) => { /* ... */ });
for (const [i, val] of arr.entries()) { /* ... */ }
// 對象
Object.entries(obj).forEach(([key, val]) => { /* ... */ });
for (const [key, val] of Object.entries(obj)) { /* ... */ }
// DOM NodeList
document.querySelectorAll('input').forEach((el, i) => { /* ... */ });
// 或 Array.from(nodes).forEach(...)
現代項目優先用原生方法,$.each 僅在需兼容舊環境或配合 jQuery 鏈式調用時使用。