jQuery 提供一組強大的陣列/類陣列工具方法,補足原生 JS 早期版本功能不足。雖然現代 JS (ES6+) 已內建大部分同等功能,但在維護舊專案或需相容舊瀏覽器時仍具參考價值。
var arr = ['墨家', '墨子', '墨翟', '兼愛非攻'];
$.each(arr, function(index, value) {
console.log(index, value);
// return false; // 相當於 break
});
回傳 false 可中斷迴圈;其它值相當於 continue。
// 保留索引 > 1 的元素
var gt1 = $.grep(arr, function(val, i) { return i > 1; });
// invert=true 取反:保留索引 <= 1
var le1 = $.grep(arr, function(val, i) { return i > 1; }, true);
回調參數順序:(value, index),與 $.each 相反,注意區別。
// 每個元素後綴 "[新加]"
var a = $.map(arr, function(val) { return val + '[新加]'; });
// 只有「墨子」加前綴
var b = $.map(arr, function(val) { return val === '墨子' ? '[只給墨子加]' + val : val; });
// 每個元素擴展為兩個
var c = $.map(arr, function(val) { return [val, val + '[擴展]']; });
// 陣列會自動扁平化
回調可回傳:新值、null(刪除該項)、陣列(展開合併)。
var idx = $.inArray('墨子', arr); // 1
var notFound = $.inArray('衛鞅', arr); // -1
if (idx >= 0) console.log('存在於索引', idx);
類似原生 indexOf,但相容舊 IE。
var merged = $.merge(arr.slice(), ['鬼谷子', '商鞅']); // 用 slice 複製避免污染原陣列
// merged: ["墨家","墨子","墨翟","兼愛非攻","鬼谷子","商鞅"]
原生 concat 不修改原陣列且可合併多個,較推薦。
var h2s = $.makeArray(document.getElementsByTagName('h2'));
var dup = $.merge(h2s.slice(), h2s); // 故意重複
var uniq = $.unique(dup); // 僅去重 DOM 元素,字串/數字陣列無效
現代用 [...new Set(arr)] 或 Array.from(new Set(arr))。
var divs = document.getElementsByTagName('div'); // HTMLCollection
var arr = $.makeArray(divs); // 真正的 Array
console.log(arr.constructor.name); // "Array"
現代用 Array.from(divs) 或 [...divs]。
var arr = $('h2').toArray(); // 同 $.makeArray
| jQuery 方法 | 現代原生替代 | 備註 |
|---|---|---|
| $.each | arr.forEach / for...of | 需中斷時 for...of 配合 break |
| $.grep | arr.filter | |
| $.map | arr.map / arr.flatMap | flatMap 對應回傳陣列展開 |
| $.inArray | arr.indexOf / arr.includes | includes 回傳布林 |
| $.merge | arr1.concat(arr2) / [...arr1, ...arr2] | 不修改原陣列 |
| $.unique | [...new Set(arr)] | 支援所有型別 |
| $.makeArray | Array.from / [...iterable] | |
| $(...).toArray() | [...$(...)] |