DIV CSS 佈局教程網

jQuery 陣列處理方法全解(一):each、grep、map、inArray
編輯:JavaScript綜合知識     

jQuery 對陣列的處理相當完整,一步到位地補上了原生 JS 缺乏的許多功能。以下逐一說明最常用的幾個工具方法,並附上可操作的範例。

一、$.each(array, callback):遍歷

不同於遍歷 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);
  });
});

二、$.grep(array, callback, [invert]):過濾

用過濾函式篩選陣列元素。回呼必須回傳 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);
});

三、$.map(array, callback):依條件轉換

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

四、$.inArray(val, array):判斷是否存在

回傳第一個參數在陣列中的位置,索引從 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(...))。

五、$.merge(first, second):合併陣列

回傳結果會修改第一個陣列——把第二個陣列的元素接在後面。它用來取代原生的 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);
});

六、$.unique(array):去除重複(限 DOM)

只處理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)] 最簡潔。

七、$.makeArray(obj):類陣列轉陣列

把類陣列物件(有 length 屬性、成員索引從 0 到 length-1)轉成真陣列,這樣就能使用 reverse()、pop() 等陣列方法。

$('input#js_makearray').click(function () {
  var _makeArr = $.makeArray(h2obj);        // h2obj 是 getElementsByTagName 的結果
  alert('轉換後的型別為:' + _makeArr.constructor.name);    // Array
});

八、$(dom).toArray():還原為陣列

$('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 版本僅需在維護舊系統時參考。

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