相比原生 JavaScript,jQuery 在陣列處理上做了大量貼心的封裝,很多原本要寫十幾行迴圈才能搞定的工作,現在一行就能完成。下面把最常見的八個陣列工具方法逐一拆解,並附上可運行的範例。
注意與遍歷 jQuery 物件的 $().each() 不同,$.each() 可以遍歷任意物件或陣列。回調函數接收兩個參數:第一個是索引(或物件屬性名),第二個是對應的值。若希望提前跳出迴圈,讓回調函數 return false 即可,其他返回值會被忽略。
var _mozi = ['墨家', '墨子', '墨翟', '兼愛非攻', '尚同尚賢'];
$.each(_mozi, function(key, val) {
// 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);
}
});
// 取出索引大於 1 的元素
var _moziGt1 = $.grep(_mozi, function(val, key) {
return key > 1;
});
alert('索引大於 1 的元素為:' + _moziGt1);
// 第三個參數傳 true,結果取反
var _moziLt1 = $.grep(_mozi, function(val, key) {
return key > 1;
}, 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() 幾乎一樣,只是作用對象換成陣列。
var _exist = $.inArray('墨子', _mozi);
var _inexistence = $.inArray('衛鞅', _mozi);
if (_exist >= 0) {
alert('墨子存在於陣列中,索引為:' + _exist);
}
if (_inexistence < 0) {
alert('衛鞅不在陣列中,回傳值為:' + _inexistence);
}
它會直接修改第一個陣列,把第二個陣列的內容接在後面。需要注意的是,這個方法一次只能合併兩個陣列,靈活度不如原生的 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() 拿到的集合。轉成真正的陣列後,就能使用 reverse()、join() 這些原生陣列方法。
var _makeArr = $.makeArray(h2obj);
alert('轉換後的資料類型為:' + _makeArr.constructor.name); // 輸出 Array
作用與 $.makeArray() 幾乎重疊,都是把集合轉成純陣列,實用性同樣有限。
var _toArr = $('h2').toArray();
alert('還原後的資料類型是:' + _toArr.constructor.name);
這八個方法中,$.each()、$.grep()、$.map()、$.inArray() 是名副其實的高頻工具,值得熟記;$.merge() 偶爾會用到;而 $.unique()、$.makeArray()、toArray() 則因為功能受限或重疊,實際上很少派上用場。