DIV CSS 佈局教程網

jQuery.map() 用法示例:把核取方塊的值拼成字串
編輯:JQuery特效代碼     

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」的組合,比手写迴圈累加字串乾淨得多,也不會出現「第一次多一個逗號」這類問題。

一個容易忽略的細節:null 會被跳過

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'),效能差異在元素多時會很明顯。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved