jQuery 對陣列的處理相當完整,一步到位地補上了原生 JS 缺乏的許多功能。以下逐一說明最常用的幾個工具方法,並附上可操作的範例。
不同於遍歷 jQuery 物件的 .each(),$.each() 可以遍歷任何物件,不限於陣列。回呼函式有兩個參數:第一個是成員名稱或陣列索引,第二個是對應的值。若回傳 false 就會中止迴圈,其他回傳值會被忽略。
var arr = ['javascript', 'php', 'java', 'c++', 'c#', 'perl', 'html', 'css'];
$.each(arr, function (key, val) {
console.log('index in arr: ' + key + ', value: ' + val);
// return false; // 想中止迴圈就回傳 false
});
相較於原生的 for...in,each 更嚴謹一點:for...in 會把物件原型鏈上可列舉的屬性也一起遍歷,而 each 依資料結構逐項走訪。
var fruit = ['蘋果', '香蕉', '橙子', '哈密瓜', '芒果'];
var h2obj = document.getElementsByTagName('h2');
$('input#js_each').click(function () {
$.each(fruit, function (key, val) {
alert('fruit 陣列中,索引:' + key + ' 對應的值為:' + val);
});
});
用過濾函式篩選陣列元素。回呼必須回傳 true 以保留元素,回傳 false 則刪除。第三個參數若為 true,會把回呼的結果取反。
var temp = $.grep(arr, function (val, key) {
if (val.indexOf('c') != -1) { return true; }
// invert 不給或為 false:收集回 true 的元素
// invert 為 true:反過來收集回 false 的元素
return false;
}, false);
console.dir(temp);
$('input#js_grep').click(function () {
$.grep(fruit, function (val, key) {
if (val == '芒果') {
alert('數值為 芒果 的索引是:' + key);
}
});
var _gt1 = $.grep(fruit, function (val, key) { return key > 1; });
alert('fruit 陣列中索引值大於 1 的元素為:' + _gt1);
var _lte1 = $.grep(fruit, function (val, key) { return key > 1; }, true);
alert('fruit 陣列中索引值小於等於 1 的元素為:' + _lte1);
});
轉換函式會為每個元素呼叫一次。它可以回傳:轉換後的值、null(該項會被移除),或一個陣列(內容會展開併入結果)。這是很強大的方法。
// 1.6 之前只支援陣列
var temp = $.map(arr, function (val, key) {
if (val === 'vb') { return null; } // 回 null 會使結果長度減 1
return val;
});
console.dir(temp);
// 1.6 起也支援物件
var obj = { key1: 'val1', key2: 'val2', key3: 'val3' };
temp = $.map(obj, function (val, key) { return val; });
console.dir(temp);
$('input#js_map').click(function () {
var _mapArrA = $.map(fruit, function (val) {
return val + '[新加]';
});
var _mapArrB = $.map(fruit, function (val) {
return val == '蘋果' ? '[只給蘋果加]' + val : val;
});
var _mapArrC = $.map(fruit, function (val) {
return [val, val + '[擴展]']; // 為每項擴展一個新元素
});
alert('每項加上「新加」後:' + _mapArrA);
alert('只給蘋果加字後:' + _mapArrB);
alert('每項擴展一個元素後:' + _mapArrC);
});
回傳第一個參數在陣列中的位置,索引從 0 起算,找不到則回傳 -1。可以把它想成陣列版的 indexOf():
console.log($.inArray('javascript', arr)); // 0
$('input#js_inarray').click(function () {
var _exist = $.inArray('芒果', fruit);
var _missing = $.inArray('榴蓮', fruit);
if (_exist >= 0) {
alert('芒果存在於 fruit 中,索引值為:' + _exist);
}
if (_missing < 0) {
alert('榴蓮不存在於 fruit 中,回傳值為:' + _missing);
}
});
要注意索引 0 是合法的結果,所以判斷必須寫 >= 0 或 !== -1,不能寫 if ($.inArray(...))。
回傳結果會修改第一個陣列——把第二個陣列的元素接在後面。它用來取代原生的 concat(),但功能較弱:concat() 可以一次合併多個陣列。
var frontEnd = ['javascript', 'css', 'html'];
var backEnd = ['java', 'php', 'c++'];
var temp = $.merge(frontEnd, backEnd);
console.dir(temp); // 合併結果
console.dir(frontEnd); // 注意:frontEnd 已被改動
// 若不想影響原陣列
// var temp = $.merge($.merge([], frontEnd), backEnd);
$('input#js_merge').click(function () {
var fruitNew = $.merge(fruit, ['水蜜桃', '火龍果', '西瓜', '楊桃']);
alert('合併後新陣列長度為:' + fruitNew.length + '。其值為:' + fruitNew);
});
只處理DOM 元素陣列,對字串或數字陣列無效。這是它最大的限制。
<div>blahblahblah....</div>
<div></div>
<div class="dup"></div>
<div class="dup"></div>
<div class="dup"></div>
<div></div>
// 取得原生 DOM 陣列,而非 jQuery 封裝的物件
var divs = $('div').get();
// 追加幾個 class 為 dup 的 div,製造重複
divs = divs.concat($('div.dup').get());
console.log("before unique: " + divs.length);
divs = $.unique(divs);
console.log("after unique: " + divs.length);
$('input#js_unique').click(function () {
var _h2Arr = $.makeArray(h2obj);
_h2Arr = $.merge(_h2Arr, _h2Arr); // 讓陣列重複一次
var _curLen = _h2Arr.length;
_h2Arr = $.unique(_h2Arr);
var _newLen = _h2Arr.length;
alert('原長度:' + _curLen + ',過濾後:' + _newLen
+ ',共過濾 ' + (_curLen - _newLen) + ' 個重複元素');
});
若要對一般陣列去重,jQuery 沒有現成方法,用 ES2015 的 [...new Set(arr)] 最簡潔。
把類陣列物件(有 length 屬性、成員索引從 0 到 length-1)轉成真陣列,這樣就能使用 reverse()、pop() 等陣列方法。
$('input#js_makearray').click(function () {
var _makeArr = $.makeArray(h2obj); // h2obj 是 getElementsByTagName 的結果
alert('轉換後的型別為:' + _makeArr.constructor.name); // Array
});
$('input#js_toarray').click(function () {
var _toArr = $('h2').toArray();
alert('h2 集合還原後的型別是:' + _toArr.constructor.name);
});
| jQuery | 原生寫法 |
|---|---|
$.each(arr, fn) | arr.forEach(fn)/for...of |
$.grep(arr, fn) | arr.filter(fn) |
$.map(arr, fn) | arr.flatMap(fn) |
$.inArray(v, arr) | arr.indexOf(v) |
$.merge(a, b) | a.concat(b) |
$.makeArray(x) | Array.from(x) |
$.unique(domArr) | [...new Set(arr)] |
如果專案已全面支援 ES2015 以上,這些原生方法在可讀性與效能上都更勝一籌,jQuery 版本僅需在維護舊系統時參考。