本文精選 jQuery 數組操作的 8 大核心方法,按使用頻度分級,提供精簡代碼示例與避坑指南,幫助開發者快速掌握實戰技巧。
var _mozi = ['墨家','墨子','墨翟','兼愛非攻','尚同尚賢'];
$.each(_mozi, function(key, val) {
alert('索引:' + key + ' 值:' + val);
// return false; // 中斷循環
});
優於 for...in:直接獲得值、可中斷、統一處理對象/陣列。
// 找值為'墨子'的索引
$.grep(_mozi, function(val, key) {
if (val === '墨子') alert('索引:' + key);
});
// 索引 > 1 的元素
var gt1 = $.grep(_mozi, function(val, key) { return key > 1; });
// 索引 ≤ 1 的元素(invert=true 取反)
var lte1 = $.grep(_mozi, function(val, key) { return key > 1; }, true);
var exist = $.inArray('墨子', _mozi); // ≥0 存在
var notExist = $.inArray('衛鞅', _mozi); // -1 不存在
if (exist >= 0) alert('存在於索引:' + exist);
替代 indexOf,兼容性更好。
// 每項加後綴
var a = $.map(_mozi, function(val) { return val + '[新加]'; });
// 單項特殊處理
var b = $.map(_mozi, function(val) { return val === '墨子' ? '[只給墨子加]' + val : val; });
// 擴展:每項生成兩項
var c = $.map(_mozi, function(val) { return [val, val + '[擴展]']; });
var merged = $.merge(_mozi, ['鬼谷子','商鞅','孫膑','龐涓','蘇秦','張儀']);
// 注意:_mozi 被修改,merged === _mozi
// 不想改原陣列:$.merge($.merge([], _mozi), otherArr)
var h2Arr = $.makeArray(h2obj); // 類數組轉陣列
h2Arr = $.merge(h2Arr, h2Arr); // 複製一份製造重複
var before = h2Arr.length;
h2Arr = $.unique(h2Arr); // 去重
alert('去重 ' + (before - h2Arr.length) + ' 個');
⚠️ 僅支持 DOM 元素陣列,字符串/數字陣列無效。
var arr = $.makeArray(h2obj);
alert(arr.constructor.name); // "Array"
現代瀏覽器用 Array.from() 或 [...obj] 更標準。
var arr = $('h2').toArray();
alert(arr.constructor.name); // "Array"
等同於 $('h2').get(),較少直接使用。
| 坑點 | 正確做法 |
|---|---|
| $.grep 回調參數順序記錯 | 固定為 (value, index),非 (index, value) |
| $.merge 修改原陣列導致副作用 | 用 $.merge($.merge([], arr1), arr2) 創建副本 |
| $.unique 用於數據陣列去重失效 | 數據去重用 $.grep + $.inArray 或 ES6 Set |
| $.makeArray / toArray 混淆 | 前者轉類數組對象,後者轉 jQuery 實例內部 DOM 陣列 |
在支持 ES5+ 的環境下,優先使用原生方法:
arr.forEach(fn) 替代 $.eacharr.filter(fn) 替代 $.greparr.map(fn) 替代 $.map(注意返回值處理差異)arr.includes(val) / arr.indexOf(val) 替代 $.inArray[...arr1, ...arr2] 替代 $.mergeArray.from(nodeList) 替代 $.makeArray但 jQuery 方法在處理選擇器結果、類數組對象、舊瀏覽器兼容時仍有不可替代優勢。