jQuery 除了操作 DOM,也附了一整套通用的 JavaScript 工具函式。以下八個方法在處理陣列時特別常用,並依實用度標註了參考價值。
全文以下面這個陣列作為示範:
var _mozi = ['墨家','墨子','墨翟','兼愛非攻','尚同尚賢'];
有別於遍歷 jQuery 物件的 $().each(),這個版本可以遍歷任何物件,不限於陣列。回呼函式有兩個參數:第一個是索引或成員名稱,第二個是對應的值。想中途中止,讓回呼回傳 false 即可,其他回傳值會被忽略。
$.each(_mozi, function(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);
});
var _moziGt1 = $.grep(_mozi, function(val, key){ return key > 1; });
var _moziLt1 = $.grep(_mozi, function(val, key){ return key > 1; }, true);
對每個元素呼叫轉換函式,回傳值可以是新值、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 + '[擴展]')]; // 一項變兩項
});
回傳第一個參數在陣列中的位置,從 0 起算,找不到則回傳 -1。可以把它想成陣列版的 indexOf()。
var _exist = $.inArray('墨子', _mozi);
var _inexistence = $.inArray('衛鞅', _mozi);
if (_exist >= 0) alert('墨子存在,索引為:' + _exist);
if (_inexistence < 0) alert('衛鞅不存在,回傳值為:' + _inexistence);
把第二個陣列的元素接在第一部之後,注意它會直接修改第一個陣列。
_moziNew = $.merge(_mozi, ['鬼谷子','商鞅','孫膑','龐涓','蘇秦','張儀']);
這個方法的功能其實不如原生的 concat(),後者可以一次併多個陣列且不會改動原物件。
移除重複元素,但它只處理 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() 的結果。
var _makeArr = $.makeArray(h2obj);
alert(_makeArr.constructor.name); // Array
var _toArr = $('h2').toArray();
alert(_toArr.constructor.name); // Array
把 jQuery 集合中的所有 DOM 元素還原成一個純陣列,方便改用原生方法處理。
把下面這段存成 html 開啟,每個按鈕對應一個方法的實際輸出:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery 陣列處理詳解</title>
</head>
<body>
<div id="demo">
<h2><input type="button" id="js_each" value="1. $.each 遍歷" /></h2>
<h2><input type="button" id="js_grep" value="2. $.grep 過濾" /></h2>
<h2><input type="button" id="js_map" value="3. $.map 轉換" /></h2>
<h2><input type="button" id="js_inarray" value="4. $.inArray 判斷" /></h2>
<h2><input type="button" id="js_merge" value="5. $.merge 合併" /></h2>
<h2><input type="button" id="js_unique" value="6. $.unique 去重" /></h2>
<h2><input type="button" id="js_makearray" value="7. $.makeArray" /></h2>
<h2><input type="button" id="js_toarray" value="8. $.toArray" /></h2>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
<script>
$(function(){
var _mozi = ['墨家','墨子','墨翟','兼愛非攻','尚同尚賢'];
var h2obj = document.getElementsByTagName('h2');
$('input#js_each').click(function(){
$.each(_mozi, function(key, val){
alert('索引:' + key + ' 對應的值為:' + val);
});
});
$('input#js_grep').click(function(){
var gt1 = $.grep(_mozi, function(val, key){ return key > 1; });
alert('索引大於 1 的元素為:' + gt1);
var lt1 = $.grep(_mozi, function(val, key){ return key > 1; }, true);
alert('索引小於等於 1 的元素為:' + lt1);
});
$('input#js_map').click(function(){
var a = $.map(_mozi, function(val){ return val + '[新加]'; });
alert('每項加上 [新加]:' + a);
var c = $.map(_mozi, function(val){ return [val, (val + '[擴展]')]; });
alert('每項擴展成兩項:' + c);
});
$('input#js_inarray').click(function(){
var exist = $.inArray('墨子', _mozi);
var no = $.inArray('衛鞅', _mozi);
alert('墨子索引:' + exist + ';衛鞅回傳:' + no);
});
$('input#js_merge').click(function(){
var merged = $.merge(_mozi, ['鬼谷子','商鞅','孫膑']);
alert('合併後長度:' + merged.length + ',內容:' + merged);
});
$('input#js_unique').click(function(){
var arr = $.makeArray(h2obj);
arr = $.merge(arr, arr);
var before = arr.length;
arr = $.unique(arr);
alert('原長度:' + before + ',去重後:' + arr.length);
});
$('input#js_makearray').click(function(){
alert('轉換後型別:' + $.makeArray(h2obj).constructor.name);
});
$('input#js_toarray').click(function(){
alert('還原後型別:' + $('h2').toArray().constructor.name);
});
});
</script>
</body>
</html>
原文出自 Mr.Think 的部落格:https://mrthink.net/jquery-array-eachgrepinarray/