jQuery 的 map() 是常被忽略的實用工具,它能把一組元素一口氣轉換成另一組值。
jQuery.map( array, callback(elementOfArray, indexInArray) ) // 回傳:Array
作用是把陣列或物件集合中的每一項,依 callback 的返回值替換成新內容。
<html>
<head>
<script type="text/javascript" src="jquery.min.js"></script>
<script>
$(function(){
$("input").click(function(){
var str = $(":checked").map(function(){
return this.value;
}).get().join(",")
$("span").html(str);
});
});
</script>
</head>
<body>
<input type="checkbox" value="a"/>a
<input type="checkbox" value="b"/>b
<input type="checkbox" value="c"/>c
<br/>
結果展示:<span></span>
</body>
</html>
.map(fn):走訪集合中的每一項,收集 callback 的回傳值,湊成一個新的 jQuery 物件。
.get():把 jQuery 物件轉成原生陣列。少了這步,後面就不能用 join()。
.join(","):原生陣列方法,用逗號串接成字串。
這個「map → get → join」的組合,比手写迴圈累加字串乾淨得多,也不會出現「第一次多一個逗號」這類問題。
jQuery 的 .map() 有個特性:callback 回傳 null 或 undefined 時,該項會被排除在結果之外。這讓它同時具備「轉換」與「篩選」的能力:
var names = $('li').map(function(){
var t = $.trim($(this).text());
return t === '' ? null : t; // 空白的直接跳過
}).get();
在支援 ES5 的環境裡,原生陣列的 map() 也能勝任,而且不必經過 jQuery:
var values = Array.prototype.map.call(
document.querySelectorAll('input:checked'),
function(el){ return el.value; }
);
var str = values.join(',');
或者用更簡潔的箭頭函式:
var str = [...document.querySelectorAll('input:checked')]
.map(el => el.value)
.join(',');
範例裡把結果塞進 $("span").html(str)。若 str 可能含有使用者輸入的內容,這裡應該改用 .text(str)——html() 會把字串當成 HTML 解析,是 XSS 的常見入口。這個範例的資料來自 checkbox 的 value(由頁面作者決定),風險低;但養成預設用 text() 的習慣,能避免在複製貼上時把風險一起帶走。
另外,選擇器 $(":checked") 會掃過整個文件。實務上應縮小範圍,例如 $('#userList :checked'),效能差異在元素多時會很明顯。