jQuery 提供了一套強大的數組/類數組工具方法,彌補了原生 JS 陣列 API 的不足(特別是 ES5 之前)。本文系統梳理 7 個核心方法,附帶實戰示例與性能建議。
遍歷陣列或對象,回調參數:(index, value)。返回 false 可中斷循環(類似 break)。
var arr = ['javascript', 'php', 'java', 'c++', 'c#'];
$.each(arr, function(key, val) {
console.log('index: ' + key + ', value: ' + val);
// if (val === 'java') return false; // 中斷
});
優勢:統一處理陣列/對象/類數組;回調內 this 指向當前值(因使用 fn.call(val, i, val))。
返回新陣列,包含使回調返回 true 的元素。invert=true 時取反。
var arr = ['javascript', 'php', 'java', 'c++', 'c#', 'vb'];
// 保留包含 'c' 的元素
var filtered = $.grep(arr, function(val, key) {
return val.indexOf('c') !== -1;
}, false); // ['c++', 'c#']
// invert=true:保留不包含 'c' 的
var filteredNot = $.grep(arr, function(val) {
return val.indexOf('c') !== -1;
}, true); // ['javascript', 'php', 'java', 'vb']
回調參數順序:(value, index) —— 與 .each() 不同,注意區分。
將每個元素通過回調轉換,返回新陣列。回調可返回:
null → 刪除該項var arr = ['a', 'b', 'c', 'd'];
// 1. 統一添加後綴
$.map(arr, function(val) { return val + '_new'; }); // ['a_new', 'b_new', 'c_new', 'd_new']
// 2. 條件修改
$.map(arr, function(val) { return val === 'b' ? '[B]' + val : val; }); // ['a', '[B]b', 'c', 'd']
// 3. 擴展:每個元素生成兩個
$.map(arr, function(val) { return [val, val + '_copy']; }); // ['a', 'a_copy', 'b', 'b_copy', ...]
// 4. 刪除特定項
$.map(arr, function(val) { return val === 'c' ? null : val; }); // ['a', 'b', 'd']
jQuery 1.6+ 還支持對象映射:$.map({k1:'v1', k2:'v2'}, fn)。
返回索引(≥0)或 -1(不存在)。類似 Array.indexOf 但兼容舊瀏覽器。
var fruits = ['蘋果', '香蕉', '橙子'];
$.inArray('香蕉', fruits); // 1
$.inArray('榴蓮', fruits); // -1
// 實戰:去重判斷
if ($.inArray(newVal, uniqueArr) === -1) {
uniqueArr.push(newVal);
}
將 second 追加到 first 並返回 first(修改原陣列)。
var front = ['js', 'css'];
var back = ['php', 'java'];
$.merge(front, back); // front 變為 ['js', 'css', 'php', 'java']
// 避免修改原陣列:
var merged = $.merge($.merge([], front), back);
注意:僅合併兩個陣列,不如原生 concat 靈活(可合併多個、不修改原陣列)。
重要限制:只能去重 DOM 元素陣列,對字符串/數字陣列無效。
var divs = $('div').get(); // 獲取原生 DOM 陣列
divs = divs.concat($('div.dup').get()); // 人為製造重複
console.log(divs.length); // 原始長度
divs = $.unique(divs); // 去重
console.log(divs.length); // 去重後長度
內部利用 sort + 節點比較 實現,適用於去重選擇器結果。
將擁有 length 屬性、索引 0~length-1 的對象(如 NodeList、arguments)轉為真正陣列。
var h2List = document.getElementsByTagName('h2'); // HTMLCollection
var arr = $.makeArray(h2List);
console.log(arr.constructor.name); // "Array"
console.log(arr.slice(1)); // 可用陣列方法
現代瀏覽器可用 Array.from() 或 [...obj] 替代。
| 方法 | 用途 | 修改原陣列 | 返回值 | 常用度 |
|---|---|---|---|---|
| $.each | 遍歷/側效果 | 否 | 原陣列/對象 | ⭐⭐⭐⭐⭐ |
| $.grep | 過濾 | 否 | 新陣列 | ⭐⭐⭐⭐ |
| $.map | 映射/轉換/擴展 | 否 | 新陣列 | ⭐⭐⭐ |
| $.inArray | 存在性/索引查詢 | 否 | Number | ⭐⭐⭐⭐ |
| $.merge | 合併 | 是 | 第一個陣列 | ⭐⭐ |
| $.unique | DOM去重 | 否 | 新陣列 | ⭐ |
| $.makeArray | 類數組轉陣列 | 否 | 新陣列 | ⭐⭐ |
forEach、filter、map、includes、concat、Array.from)$.grep 回調參數順序 (value, index) 易混淆,寫註釋$.unique 僅用於 DOM 去重,切勿用於數據陣列$.map 返回陣列展開特性可替代雙層循環