map() 會把集合中每個元素依序傳入你提供的函式,並用函式的回傳值組出新的 jQuery 物件。它適合用來「從一組元素中萃取某個屬性或計算結果」,例如把所有列表項目的 id 收集成陣列。
.map(callback(index, domElement))
回呼函式會收到兩個參數:目前元素的索引與原生 DOM 元素(注意不是 jQuery 物件,若要使用 jQuery 方法需自行包裝)。回傳值只要不是 null 或 undefined,就會被收進結果集合。
map() 的回傳值是「jQuery 封裝的陣列」。若你要的是真正的原生陣列(以便使用 join、filter 等原生方法),必須串上 get() 把它取出來。這是新手最常卡住的地方。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>jquery map</title>
<script language="javascript" src="../jquery-1.11.1.js"></script>
<script language="javascript">
$(function(){
// 1. map 也可以直接用在純陣列上('$.map')
var str = $.map([1, 2, 3], function(n){
return n;
}).join();
console.log(str); // "1,2,3"
// 2. 用在元素集合上,取出每個 li 的 id
var data = $('#list li').map(function(){
return $(this).attr('id');
}).get().join(); // 別忘了 .get()
console.log(data); // "li1,li2,li3,li4,li5"
});
</script>
</head>
<body>
<div>
<ul id="list">
<li id="li1">列表1</li>
<li id="li2">列表2</li>
<li id="li3">列表3</li>
<li id="li4">列表4</li>
<li id="li5">列表5</li>
</ul>
</div>
</body>
</html>
兩者都會遍歷集合,但目的不同:each() 是「對每個元素做一件事」,回傳原本的集合以便鏈式呼叫;map() 是「把每個元素轉換成另一個值」,回傳新集合。判斷方式很簡單——需要收集結果就用 map,只需要副作用(例如設定樣式、綁定事件)就用 each。
另外注意 $.map()(挂在 jQuery 命名空間上,用於原生陣列)與 $().map()(元素集合的方法)是兩個不同的 API,回呼參數與 this 指向也不同:前者回呼的 this 是全域物件,後者的 this 是當前 DOM 元素。
// 收集所有被勾選的 checkbox 值
var checked = $("input[type=checkbox]:checked").map(function(){
return this.value;
}).get();
// 過濾並轉換:只保留有 href 的連結
var links = $("a").map(function(){
var href = $(this).attr('href');
return href ? href : null; // 回傳 null 會被排除
}).get();
最後一個技巧值得記住:回呼中回傳 null 或 undefined 時,該項不會進入結果集合,因此 map 可以同時完成「轉換」與「過濾」兩件事。