萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery map() 方法完整指南:陣列/集合轉換、與 each() 差異、實戰模式詳解

map() vs each() 核心差異

特性.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>

核心機制深度解析

1. .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() 的前身實現。

2. null/undefined 自動過濾

$.map([1,2,3], v => v === 2 ? null : v * 2); // [2, 6] (2 被過濾)

利用此特性可實現「過濾+轉換」一步到位。

3. .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(); // 一行搞定

4. 兩個 map():$.map() (靜態) vs .map() (實例)

方法參數順序適用對象返回
$.map(array, callback)(value, index)陣列/物件/類陣列原生陣列
$collection.map(callback)(index, element)jQuery 物件jQuery 物件 (需 .get())

參數順序相反 是最大坑點!

實戰應用模式

1. 表單資料序列化為物件

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), {});

2. 列表項目轉換為選項物件

const options = $('#sourceList li').map((_, el) => ({
  value: $(el).data('id'),
  label: $(el).text().trim(),
  disabled: $(el).hasClass('disabled')
})).get();

3. 計算衍生資料

// 計算每行小計
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) => ...)
  • 返回 jQuery 物件而非陣列:實例方法必須加 .get()
  • null/undefined 被靜默過濾:若需保留 null,請返回 Symbol() 或特殊標記物件
  • 不支援中斷:需中斷請用 .each() 或原生迴圈
  • 物件遍歷順序:$.map(obj, fn) 按鍵名順序,非索引

總結

.map() 是「轉換」的利器:輸入集合 → 逐項轉換 → 輸出新陣列。核心記住三點:

  1. 實例方法參數順序 (index, element),靜態方法 (value, index)
  2. 必須 .get() 取得原生陣列
  3. 返回 null/undefined 會被自動過濾 (可用於過濾)

現代專案中,簡單陣列轉換優先用原生 Array.map(),jQuery 集合轉換用 $().map().get()。

copyright © 萬盛學電腦網 all rights reserved