本文把 jQuery 的陣列方法依實務使用頻率分為三級,方便快速判斷「這個該不該記」。範例統一使用同一組測試資料。
不同於遍歷 jQuery 物件的 .each(),此方法可用於遍歷任何物件。回故有兩個參數:第一個是索引,第二個是當前值。回傳 false 可中止迴圈,其他回傳值會被忽略。
var _mozi = ['墨家', '墨子', '墨翟', '兼愛非攻', '尚同尚賢'];
$.each(_mozi, function (key, val) {
alert('_mozi 陣列中,索引:' + key + ' 對應的值為:' + val);
});
相較於原生的 for...in,each 更可靠:for...in 會把原型鏈上的可列舉屬性也走一遍,而且取值還得寫 arrName[key]。
使用過濾函式篩選元素。回呼必須回傳 true 保留、false 刪除。第三個參數為 true 時會把結果取反。
$.grep(_mozi, function (val, key) {
if (val == '墨子') {
alert('數值為 墨子 的索引是:' + key);
}
});
var _gt1 = $.grep(_mozi, function (val, key) { return key > 1; });
alert('_mozi 中索引值大於 1 的元素為:' + _gt1);
var _lte1 = $.grep(_mozi, function (val, key) { return key > 1; }, true);
alert('_mozi 中索引值小於等於 1 的元素為:' + _lte1);
回傳該值在陣列中的位置,從 0 起算,找不到回傳 -1。indexOf() 是字串的首次出現位置,$.inArray() 則是陣列元素的索引,用法相同。
var _exist = $.inArray('墨子', _mozi);
var _missing = $.inArray('衛鞅', _mozi);
if (_exist >= 0) {
alert('墨子存在於 _mozi 中,索引值是:' + _exist);
}
if (_missing < 0) {
alert('衛鞅不存在於 _mozi 中,回傳值為:' + _missing);
}
務必寫 >= 0 而非直接判斷真假,因為索引 0 是第一個元素,在 if 中會被當成 false。
轉換函式會為每個元素呼叫,可回傳轉換後的值、null(刪除該項)或一個陣列(展開併入結果)。功能強大但不常用,因為多數情況用原生 map 就夠了。
var _mapArrA = $.map(_mozi, function (val) {
return val + '[新加]';
});
var _mapArrB = $.map(_mozi, function (val) {
return val == '墨子' ? '[只給墨子加]' + val : val;
});
var _mapArrC = $.map(_mozi, function (val) {
return [val, val + '[擴展]']; // 為每項擴展一個新元素
});
alert('每項加上「新加」後:' + _mapArrA);
alert('只給墨子加字後:' + _mapArrB);
alert('每項擴展一個元素後:' + _mapArrC);
回傳結果會修改第一個陣列:第一個的元素後面接上第二個的元素。它用來取代原生 concat(),但功能較弱——concat 可一次合併多個陣列,且不會改動原陣列。
var _moziNew = $.merge(_mozi, ['鬼谷子', '商鞅', '孫膑', '龐涓', '蘇秦', '張儀']);
alert('合併後長度為:' + _moziNew.length + '。其值為:' + _moziNew);
// 更安全的等價寫法(不改動原陣列)
// var _moziNew = _mozi.concat(['鬼谷子', '商鞅']);
只處理DOM 元素陣列,對字串或數字陣列無效。看名字以為很方便,仔細一看限制這麼大,實際上幾乎用不到。
var _h2Arr = $.makeArray(h2obj);
_h2Arr = $.merge(_h2Arr, _h2Arr); // 讓陣列重複一次
var _curLen = _h2Arr.length;
_h2Arr = $.unique(_h2Arr);
var _newLen = _h2Arr.length;
alert('原長度:' + _curLen + ',過濾後:' + _newLen
+ ',共過濾 ' + (_curLen - _newLen) + ' 個重複元素');
把類陣列物件(有 length、可用索引取值)轉成真陣列。jQuery 官網的說明寫得很模糊,實際上就是把 getElementsByTagName() 這類結果轉成可用陣列方法的物件。
var _makeArr = $.makeArray(h2obj);
alert('h2 元素集合轉換後的型別為:' + _makeArr.constructor.name); // Array
var _toArr = $('h2').toArray();
alert('h2 元素集合還原後的型別是:' + _toArr.constructor.name);
| 等級 | 方法 | 用途 | 原生替代 |
|---|---|---|---|
| 常用 | $.each | 遍歷 | forEach/for...of |
| 常用 | $.grep | 過濾 | filter |
| 常用 | $.inArray | 判斷存在 | indexOf/includes |
| 一般 | $.map | 轉換 | map/flatMap |
| 一般 | $.merge | 合併 | concat |
| 不常用 | $.unique | 去重(限 DOM) | new Set() |
| 不常用 | $.makeArray | 類陣列轉陣列 | Array.from() |
| 不常用 | $(dom).toArray() | 還原陣列 | Array.from() |
記住三個常用的即可應付絕大多數場景;其餘在讀到舊程式碼時能認出來就足夠了。