DIV CSS 佈局教程網

jQuery 陣列處理 API 全解:each、grep、map、inArray 等八個方法
編輯:JQuery特效代碼     

除了 DOM 操作,jQuery 也提供了一整套陣列與物件處理工具。這些方法掛在 jQuery 命名空間下,脫離 DOM 也能單獨使用。以下逐一說明 eight 個常用方法,並附上可執行的例子(範例統一使用同一份「墨家」主題的陣列)。

1. $.each(array, [callback]):遍歷(常用)

不同於遍歷 jQuery 物件的 $().each(),這個方法可以遍歷任何物件或陣列。回呼函式有兩個參數:第一個是索引(或物件成員名稱),第二個是對應的值。若需要提早結束迴圈,讓回呼 return false 即可,其他回傳值會被忽略。

var _mozi = ['墨家', '墨子', '墨翟', '兼愛非攻', '尚同尚賢'];

$.each(_mozi, function(key, val){
  // 第一個參數是索引,第二個是當前值
  alert('_mozi 陣列中,索引:' + key + ' 對應的值為:' + val);
});

相較於原生的 for...in,each 更穩健:for...in 雖然也能遍歷陣列並取得索引,但值還要透過 arrName[key] 另外取。

2. $.grep(array, callback, [invert]):過濾陣列(常用)

使用過濾函式篩選元素,至少傳入兩個參數:待過濾陣列與過濾函式。過濾函式必須 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);

3. $.map(array, [callback]):依條件轉換陣列(一般)

轉換函式會為每個元素呼叫一次,可以回傳轉換後的值、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);

4. $.inArray(val, array):判斷值是否存在(常用)

回傳第一個參數在陣列中的位置,從 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);
}

5. $.merge(first, second):合併兩個陣列(一般)

回傳結果會修改第一個陣列——第一個陣列的元素後面接上第二個陣列的元素。這是 jQuery 版本的 concat,但功能不如原生 concat() 強大,後者能同時合併多個陣列。

_moziNew = $.merge(_mozi, ['鬼谷子', '商鞅', '孫臏', '龐涓', '蘇秦', '張儀']);
alert('合併後新陣列長度為:' + _moziNew.length + ',其值為:' + _moziNew);

6. $.unique(array):去除重複元素(不常用)

用來刪除陣列中重複的元素,聽起來很方便,但仔細看說明會發現:它只處理 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) + ' 個重複元素');

7. $.makeArray(obj):類陣列物件轉陣列(不常用)

把類陣列物件(有 length 屬性、成員索引為 0 到 length-1)轉成真正的陣列,例如把 getElementsByTagName 取得的元素集合轉成陣列。jQuery 官方文件的說明相當模糊,實際上就是做型別轉換。

var _makeArr = $.makeArray(h2obj);
alert('轉換後的型別為:' + _makeArr.constructor.name);   // 輸出 Array

8. $(dom).toArray():把 jQuery 集合還原為陣列(不常用)

把 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 可用,語意更清楚、效能也更好。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved