jQuery 提供兩個處理陣列的工具函式,用途完全不同:一個是「變換」,一個是「遍歷」。
對陣列中的每個元素呼叫 callback(),把回傳值收集成一個新陣列,原陣列不變。
$(function () {
var arrInt = [1, 3, 5, 79];
var b = $.map(arrInt, function (value, key, a) {
return value * 2; // map 回傳的是一個新陣列
});
});
執行後 b 是 [2, 6, 10, 158],arrInt 保持原樣。
有個容易忽略的特性:callback 回傳 null 或 undefined 時,該元素會被從結果陣列中剔除。這讓 $.map() 同時具備了 filter 的能力,例如:
var evens = $.map([1, 2, 3, 4, 5], function (n) {
return n % 2 === 0 ? n : null; // 基數被濾掉
});
// evens = [2, 4]
主要用來遍歷陣列,不修改陣列。普通陣列與「鍵值對陣列」(也就是物件)都能用它走一輪。在 each 的函式中可以直接用 this 代表目前元素的值。
典型應用是取出核取方塊的勾選項:
<script type="text/javascript">
$(function () {
var arr = [];
$('input[type=checkbox]').click(function () {
$('input[type=checkbox]:checked').each(function (key, value) {
arr[key] = value; // 這裡的 value 其實是 DOM 元素
});
var lengtha = $('input[type=checkbox]:checked').length;
$('#spMsg').text('共有 ' + lengtha + ' 被選中');
});
});
</script>
這裡要更正一個常見誤解:each 回呼的第一個參數是索引,第二個才是元素本身;而 this 指向的是原生 DOM 元素,不是 jQuery 物件。所以要取它的值應該寫 $(this).val(),直接 $(this).text() 拿核取方塊的文字也是取不到的——核取方塊沒有文字內容,標籤文字寫在 input 外面。範例中若真要收集值,正確寫法是:
$('input[type=checkbox]:checked').each(function () {
arr.push($(this).val()); // 取 input 的 value 屬性
});
另外,原範例中的 'input[type=checbox]' 少了一個 k,這種拼字錯誤在選擇器裡不會報錯,只會靜靜地選不到任何元素,除錯時特別耗時間。
$.map()。$.each()。補充一點:這兩個函式在 jQuery 3 之後已被標記為建議改用原生方法。$.map(arr, fn) 可用 arr.map(fn) 取代,$.each(arr, fn) 可用 arr.forEach(fn) 取代。差別是原生 map 不會濾除 null,且 this 指向需自行處理。若同時要遍歷 DOM 集合,.each() 方法(注意是 $('p').each() 而非 $.each())仍然是 jQuery 的標準做法。