除了 DOM 操作,jQuery 也提供了一整套陣列與物件處理工具。這些方法掛在 jQuery 命名空間下,脫離 DOM 也能單獨使用。以下逐一說明 eight 個常用方法,並附上可執行的例子(範例統一使用同一份「墨家」主題的陣列)。
不同於遍歷 jQuery 物件的 $().each(),這個方法可以遍歷任何物件或陣列。回呼函式有兩個參數:第一個是索引(或物件成員名稱),第二個是對應的值。若需要提早結束迴圈,讓回呼 return false 即可,其他回傳值會被忽略。
var _mozi = ['墨家', '墨子', '墨翟', '兼愛非攻', '尚同尚賢'];
$.each(_mozi, function(key, val){
// 第一個參數是索引,第二個是當前值
alert('_mozi 陣列中,索引:' + key + ' 對應的值為:' + val);
});
相較於原生的 for...in,each 更穩健:for...in 雖然也能遍歷陣列並取得索引,但值還要透過 arrName[key] 另外取。
使用過濾函式篩選元素,至少傳入兩個參數:待過濾陣列與過濾函式。過濾函式必須 return true 保留元素、return false 刪除元素。第三個參數設為 true 時,會把過濾結果取反。
$.grep(_mozi, function(val, key){
if(val == '墨子'){
alert('數值為 墨子 的索引是:' + key);
}
});
var _moziGt1 = $.grep(_mozi, function(val, key){
return key > 1;
});
alert('索引值大於 1 的元素為:' + _moziGt1);
var _moziLt1 = $.grep(_mozi, function(val, key){
return key > 1;
}, true); // 第三個參數為 true,結果取反
alert('索引值小於等於 1 的元素為:' + _moziLt1);
轉換函式會為每個元素呼叫一次,可以回傳轉換後的值、null(刪除該項目),或一個陣列(會展開附加到結果中)。這是個很強大的方法,可以批次更新值或擴展出新的元素。
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);
回傳第一個參數在陣列中的位置,從 0 開始計數,找不到則回傳 -1。
還記得 indexOf() 嗎?它回傳字串首次出現的位置;$.inArray() 則回傳值在陣列中的位置。同樣地,找到時得到 >= 0 的值,找不到則為 -1。有了它,判斷某值是否存在於陣列中變得非常容易。
var _exist = $.inArray('墨子', _mozi);
var _inexistence = $.inArray('衛鞅', _mozi);
if(_exist >= 0){
alert('墨子 存在於陣列 _mozi 中,索引值為:' + _exist);
}
if(_inexistence < 0){
alert('衛鞅 不存在於陣列 _mozi 中,回傳值為:' + _inexistence);
}
回傳結果會修改第一個陣列——第一個陣列的元素後面接上第二個陣列的元素。這是 jQuery 版本的 concat,但功能不如原生 concat() 強大,後者能同時合併多個陣列。
_moziNew = $.merge(_mozi, ['鬼谷子', '商鞅', '孫臏', '龐涓', '蘇秦', '張儀']);
alert('合併後新陣列長度為:' + _moziNew.length + ',其值為:' + _moziNew);
用來刪除陣列中重複的元素,聽起來很方便,但仔細看說明會發現:它只處理 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 屬性、成員索引為 0 到 length-1)轉成真正的陣列,例如把 getElementsByTagName 取得的元素集合轉成陣列。jQuery 官方文件的說明相當模糊,實際上就是做型別轉換。
var _makeArr = $.makeArray(h2obj);
alert('轉換後的型別為:' + _makeArr.constructor.name); // 輸出 Array
把 jQuery 集合中的所有 DOM 元素還原成一個陣列。與 $.makeArray 功能高度重疊,兩者選一個用即可。
var _toArr = $('h2').toArray();
alert('還原後的型別是:' + _toArr.constructor.name);
實務上最常用的是 $.each、$.grep、$.map 與 $.inArray,這四個幾乎能解決大部分資料處理需求。至於 $.unique 與 $.makeArray,在現代專案中改用 ES5+ 的原生方法會更合適:去重可用 [...new Set(arr)],轉陣列可用 Array.from() 或 [].slice.call(),map/filter 也有原生的 Array.prototype.map 與 filter 可用,語意更清楚、效能也更好。