| 特性 | .map() | .each() |
|---|---|---|
| 目的 | 轉換:產生新陣列 | 迭代:副作用操作 |
| 返回值 | 新 jQuery 物件 (包裹新陣列) | 原 jQuery 物件 (鏈式) |
| 回調返回 | 新值 (會被收集到新陣列) | 忽略 (用於中斷控制) |
| 中斷支援 | 不支援 | return false 中斷 |
| null/undefined | 會被過濾掉 (不加入結果) | 無影響 |
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery map() 方法示範</title>
<style>
.container { max-width: 700px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
.demo { margin: 20px 0; padding: 20px; border: 1px solid #e0e0e0; border-radius: 8px; }
.demo h3 { margin-top: 0; color: #1976d2; }
.code { background: #263238; color: #aed581; padding: 12px; border-radius: 4px; font-family: monospace; font-size: 13px; white-space: pre-wrap; }
button { padding: 8px 16px; margin: 5px; background: #1976d2; color: white; border: none; border-radius: 4px; cursor: pointer; }
button.secondary { background: #757575; }
.output { background: #f5f5f5; padding: 12px; border-radius: 4px; font-family: monospace; min-height: 60px; white-space: pre-wrap; }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<div class="container">
<h2>jQuery map() vs each() 互動對比</h2>
<div class="demo">
<h3>1. 陣列轉換:數值 × 2</h3>
<button id="btnMapArray">$.map(arr, x => x*2)</button>
<button id="btnEachArray" class="secondary">$.each(arr, push)</button>
<div class="output" id="out1"></div>
</div>
<div class="demo">
<h3>2. jQuery 集合轉換:提取 data-id 陣列</h3>
<ul id="itemList">
<li data-id="101">商品 A</li>
<li data-id="102">商品 B</li>
<li data-id="103">商品 C</li>
</ul>
<button id="btnMapJQ">$items.map() 取 data-id 陣列</button>
<button id="btnEachJQ" class="secondary">.each() 手動構建陣列</button>
<div class="output" id="out2"></div>
</div>
<div class="demo">
<h3>3. 過濾 + 轉換:只取偶數索引並轉大寫</h3>
<button id="btnMapFilter">$.map() 實現</button>
<div class="output" id="out3"></div>
</div>
<div class="demo">
<h3>4. 扁平化:二維陣列轉一維</h3>
<button id="btnFlatten">$.map(二維陣列, 扁平化)</button>
<div class="output" id="out4"></div>
</div>
</div>
<script>
$(function() {
// 1. 陣列轉換
const arr = [1, 2, 3, 4, 5];
$('#btnMapArray').on('click', () => {
const result = $.map(arr, (val, i) => val * 2);
$('#out1').text(`原陣列: [${arr}]\nmap 結果: [${result}]\n類型: ${Object.prototype.toString.call(result)}`);
});
$('#btnEachArray').on('click', () => {
const result = [];
$.each(arr, (i, val) => result.push(val * 2));
$('#out1').text(`原陣列: [${arr}]\neach 結果: [${result}]\n類型: ${Object.prototype.toString.call(result)}`);
});
// 2. jQuery 集合轉換
$('#btnMapJQ').on('click', () => {
const ids = $('#itemList li').map((i, el) => $(el).data('id')).get();
$('#out2').text(`map().get(): [${ids}] (陣列)`);
});
$('#btnEachJQ').on('click', () => {
const ids = [];
$('#itemList li').each((i, el) => ids.push($(el).data('id')));
$('#out2').text(`each 手動構建: [${ids}] (陣列)`);
});
// 3. 過濾 + 轉換 (map 返回 null/undefined 會被自動過濾)
$('#btnMapFilter').on('click', () => {
const words = ['apple', 'banana', 'cherry', 'date'];
const result = $.map(words, (val, i) => {
if (i % 2 === 0) return val.toUpperCase(); // 偶數索引轉大寫
return null; // 奇數索引過濾掉
});
$('#out3').text(`原: [${words}]\n結果: [${result}] (只保留索引 0,2)`);
});
// 4. 扁平化
$('#btnFlatten').on('click', () => {
const matrix = [[1,2], [3,4], [5,6]];
const flat = $.map(matrix, (subArr) => subArr); // 返回子陣列自動展平
$('#out4').text(`原: ${JSON.stringify(matrix)}\n扁平化: [${flat}]`);
});
});
</script>
</body>
</html>
.map() 自動扁平化// 回調返回陣列時,會被展平合併
$.map([[1,2], [3,4]], (sub) => sub); // [1,2,3,4]
$.map([1,2], (v) => [v, v*10]); // [1,10,2,20]
這是 Array.prototype.flatMap() 的前身實現。
null/undefined 自動過濾$.map([1,2,3], v => v === 2 ? null : v * 2); // [2, 6] (2 被過濾)
利用此特性可實現「過濾+轉換」一步到位。
.get() 解包為原生陣列const $mapped = $items.map((i, el) => $(el).data('id')); // jQuery 物件
const arr = $mapped.get(); // 原生陣列 [101, 102, 103]
// 或
const arr = $items.map((i, el) => $(el).data('id')).get(); // 一行搞定
$.map() (靜態) vs .map() (實例)| 方法 | 參數順序 | 適用對象 | 返回 |
|---|---|---|---|
$.map(array, callback) | (value, index) | 陣列/物件/類陣列 | 原生陣列 |
$collection.map(callback) | (index, element) | jQuery 物件 | jQuery 物件 (需 .get()) |
參數順序相反 是最大坑點!
const formData = $('#myForm').serializeArray() // [{name, value}, ...]
.reduce((obj, field) => {
if (obj[field.name]) {
obj[field.name] = [].concat(obj[field.name], field.value); // 同名轉陣列
} else {
obj[field.name] = field.value;
}
return obj;
}, {});
// 或用 map 更簡潔
const data = $('#myForm').find('input, select, textarea').map((_, el) => {
const $el = $(el);
return [$el.attr('name'), $el.val()];
}).get().reduce((obj, [k,v]) => (obj[k]=v, obj), {});
const options = $('#sourceList li').map((_, el) => ({
value: $(el).data('id'),
label: $(el).text().trim(),
disabled: $(el).hasClass('disabled')
})).get();
// 計算每行小計
const subtotals = $('#cart tbody tr').map((_, row) => {
const qty = parseInt($(row).find('.qty').val()) || 0;
const price = parseFloat($(row).find('.price').text()) || 0;
return qty * price;
}).get();
const total = subtotals.reduce((sum, v) => sum + v, 0);
| 場景 | 推薦方案 | 理由 |
|---|---|---|
| 簡單陣列轉換 | arr.map(fn) | 原生、無依賴、效能最佳 |
| jQuery 集合轉換 | $el.map(fn).get() | jQuery 專用、鏈式友好 |
| 需中斷/非同步 | for...of + push | 完全控制流程 |
| 大量資料 (10萬+) | 原生 for 迴圈 | 避免函數呼叫開銷 |
$.map(arr, (val, i) => ...) vs $el.map((i, el) => ...).get()Symbol() 或特殊標記物件.each() 或原生迴圈$.map(obj, fn) 按鍵名順序,非索引.map() 是「轉換」的利器:輸入集合 → 逐項轉換 → 輸出新陣列。核心記住三點:
(index, element),靜態方法 (value, index).get() 取得原生陣列null/undefined 會被自動過濾 (可用於過濾)現代專案中,簡單陣列轉換優先用原生 Array.map(),jQuery 集合轉換用 $().map().get()。