DIV CSS 佈局教程網

jQuery 陣列處理工具方法整理:each、grep、map、inArray 等
編輯:JQuery特效代碼     

除了操作 DOM,jQuery 也提供了一整套 $. 開頭的靜態工具方法來處理陣列與類陣列物件。以下逐一說明並附上可執行的測試片段。

$.each(array, callback):遍歷

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

var arr = ['javascript', 'php', 'java', 'c++', 'c#', 'perl', 'vb', 'html', 'css', 'objective-c'];
$.each(arr, function(key, val) {
  // firebug console
  console.log('index in arr:' + key + ", corresponding value:" + val);
  // 若想退出迴圈
  // return false;
});

實際操作範例:

var fruit = ['蘋果','香蕉','橙子','哈密瓜','芒果'];
// 用原生 getElementsByTagName 取得 h2 元素的物件集合
var h2obj = document.getElementsByTagName('h2');

// 用 $.each() 遍歷陣列
$('input#js_each').click(function(){
  $.each(fruit, function(key, val){
    // 回呼函式有兩個參數,第一個是索引,第二個是目前的值
    alert('fruit 陣列中,索引:' + key + ' 對應的值為:' + val);
  });
});

相對於原生的 for...in,$.each 更穩健一點。for...in 也能遍歷陣列並取得索引,但值需要再用 arrName[key] 取出,而且會把繼承來的可列舉屬性一起掃進來。

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

用過濾函式篩選陣列元素,至少要傳兩個參數:待過濾陣列與過濾函式。過濾函式回傳 true 表示保留、false 表示刪除。第三個參數 invert 設為 true 時會把結果反轉。

var temp = [];
temp = $.grep(arr, function(val, key) {
  if (val.indexOf('c') != -1)
    return true;
  // 若 [invert] 不給或為 false,只收集回傳 true 的元素
  // 若 [invert] 為 true,則收集回傳 false 的元素
}, false);
console.dir(temp);

測試範例:

// 用 $.grep() 過濾陣列
$('input#js_grep').click(function(){
  $.grep(fruit, function(val, key){
    // 過濾函式的第一個參數為目前元素,第二個為索引
    if (val == '芒果') {
      alert('陣列值為 芒果 的下標是: ' + key);
    }
  });

  var _moziGt1 = $.grep(fruit, function(val, key){
    return key > 1;
  });
  alert('fruit 陣列中索引值大於 1 的元素為: ' + _moziGt1);

  var _moziLt1 = $.grep(fruit, function(val, key){
    return key > 1;
  }, true);
  // 此處傳入第三個參數,對過濾函式的回傳值取反
  alert('fruit 陣列中索引值小於等於 1 的元素為: ' + _moziLt1);
});

$.map(array, callback):轉換

轉換函式會為每個元素呼叫一次。它可以回傳轉換後的值、null(從結果中刪除該項)、或一個陣列(內容會被展開併入結果)。這個方法很強大,可以依條件改寫元素值,或為每個元素擴展出多個副本。

// 1.6 之前的版本只支援陣列
temp = $.map(arr, function(val, key) {
  // 回傳 null,結果陣列的長度會減 1
  if (val === 'vb') return null;
  return val;
});
console.dir(temp);

// 1.6 開始支援 json 格式的 object
var obj = {key1: 'val1', key2: 'val2', key3: 'val3'};
temp = $.map(obj, function(val, key) {
  return val;
});
console.dir(temp);

測試範例:

// 用 $.map() 依條件轉換陣列
$('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() 回傳字串的首次出現位置,$.inArray() 回傳元素在陣列中的位置,行為幾乎一致。有了它,判斷某值是否存在於陣列中就變得輕而易舉。

// 回傳元素在陣列中的位置,0 為起始位置,回傳 -1 則表示找不到
console.log($.inArray('javascript', arr));

測試範例:

// 用 $.inArray 判斷值是否在陣列中
$('input#js_inarray').click(function(){
  var _exist = $.inArray('芒果', fruit);
  var _inexistence = $.inArray('榴蓮', fruit);
  if (_exist >= 0) {
    alert('芒果 存在於陣列 fruit 中,其索引值是: ' + _exist);
  }
  if (_inexistence < 0) {
    alert('榴蓮 不存在於陣列 fruit 中,回傳值為: ' + _inexistence);
  }
});

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

回傳結果會直接修改第一個陣列——把第二個陣列的元素接在後面。這是 jQuery 版本的 concat(),但功能沒有原生 concat() 強,後者可以一次合併多個陣列。

var frontEnd = ['javascript', 'css', 'html'],
    backEnd  = ['java', 'php', 'c++'];

// 這種寫法會修改第一個參數,即 frontEnd 陣列
temp = $.merge(frontEnd, backEnd);
console.dir(temp);
console.dir(frontEnd);

// 若想避免影響原陣列,可以這樣寫
// $.merge($.merge([], frontEnd), backEnd);

測試範例:

// 用 $.merge() 合併兩個陣列
$('input#js_merge').click(function(){
  // 原生 concat() 寫起來可能更簡潔
  var fruitNew = $.merge(fruit, ['水蜜桃','火龍果','西瓜','楊桃','荔枝','龍眼']);
  alert('合併後新陣列長度為: ' + fruitNew.length + '。其值為: ' + fruitNew);
});

$.unique(array):去除重複

刪除陣列中重複的元素。要注意的是,這個方法只處理 DOM 元素陣列,無法處理字串或數字陣列。第一次看到時覺得很方便,仔細一看限制這麼多,實用性就打了不少折扣。

<div>blahblahblah....</div>
<div></div>
<div class="dup"></div>
<div class="dup"></div>
<div class="dup"></div>
<div></div>

// $.unique 只支援 DOM 元素陣列,不支援其他型別
// 取得原始的 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);

測試範例:

// 用 $.unique() 過濾陣列中重複元素(僅限 DOM 元素陣列)
$('input#js_unique').click(function(){
  var _h2Arr = $.makeArray(h2obj);
  // 把陣列 _h2Arr 重複一次
  _h2Arr = $.merge(_h2Arr, _h2Arr);
  var _curLen = _h2Arr.length;
  _h2Arr = $.unique(_h2Arr);
  var _newLen = _h2Arr.length;
  alert('陣列 _h2Arr 原長度值為: ' + _curLen + ',過濾後為: ' + _newLen +
        '。共過濾 ' + (_curLen - _newLen) + ' 個重複元素');
});

若需要對一般陣列去重,ES5 之後可用 arr.filter(function(v, i, a){ return a.indexOf(v) === i; }),或使用 Set。

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

把類陣列物件轉成真正的陣列。所謂類陣列,是指具備 length 屬性、成員索引從 0 到 length-1 的物件,例如 getElementsByTagName() 回傳的集合。轉成真陣列之後,就能使用 reverse()、pop() 等原生陣列方法。

// 用 $.makeArray() 做類陣列轉換
$('input#js_makearray').click(function(){
  var _makeArr = $.makeArray(h2obj);
  alert('h2 元素物件集合的資料型別轉換為: ' + _makeArr.constructor.name);
});

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

把 jQuery 集合中的所有 DOM 元素還原成一個陣列。使用頻率不高,功能上與 $.makeArray() 相當接近,但語意更直接。

// 用 $(dom).toArray() 把所有 DOM 元素還原成陣列
$('input#js_toarray').click(function(){
  var _toArr = $('h2').toArray();
  alert('h2 元素集合還原後的資料型別是: ' + _toArr.constructor.name);
});

選用小抄

  • 要遍歷並可中斷 → $.each
  • 要篩選 → $.grep
  • 要轉換或展開 → $.map
  • 要判斷存在 → $.inArray
  • 要合併 → $.merge(注意會改動第一個陣列)
  • DOM 去重 → $.unique;一般去重請用 filter 或 Set
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved