除了操作 DOM,jQuery 也提供了一整套 $. 開頭的靜態工具方法來處理陣列與類陣列物件。以下逐一說明並附上可執行的測試片段。
不同於用來遍歷 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] 取出,而且會把繼承來的可列舉屬性一起掃進來。
用過濾函式篩選陣列元素,至少要傳兩個參數:待過濾陣列與過濾函式。過濾函式回傳 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);
});
轉換函式會為每個元素呼叫一次。它可以回傳轉換後的值、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);
});
回傳第一個參數在陣列中的位置,從 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);
}
});
回傳結果會直接修改第一個陣列——把第二個陣列的元素接在後面。這是 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);
});
刪除陣列中重複的元素。要注意的是,這個方法只處理 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。
把類陣列物件轉成真正的陣列。所謂類陣列,是指具備 length 屬性、成員索引從 0 到 length-1 的物件,例如 getElementsByTagName() 回傳的集合。轉成真陣列之後,就能使用 reverse()、pop() 等原生陣列方法。
// 用 $.makeArray() 做類陣列轉換
$('input#js_makearray').click(function(){
var _makeArr = $.makeArray(h2obj);
alert('h2 元素物件集合的資料型別轉換為: ' + _makeArr.constructor.name);
});
把 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(注意會改動第一個陣列)$.unique;一般去重請用 filter 或 Set