萬盛學電腦網

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

jQuery each() 遍歷陣列/物件/jQuery集合完整指南:語法差異、中斷迴圈、上下文綁定實戰

三種 each() 形式對比

形式語法適用對象回調參數this 指向
$.each() (靜態方法)$.each(collection, callback)陣列、物件、類陣列(index, value)value (原始值)
.each() (實例方法)$collection.each(callback)jQuery 物件 (DOM 集合)(index, element)element (DOM 元素)
.each() 隱式迴圈多數 setter 方法內建jQuery 物件--

完整互動範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>jQuery each() 遍歷示範</title>
  <style>
    .container { max-width: 700px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
    .demo-section { margin: 20px 0; padding: 20px; border: 1px solid #e0e0e0; border-radius: 8px; }
    .demo-section 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; overflow-x: auto; }
    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 each() 三大用法互動示範</h2>
    
    <div class="demo-section">
      <h3>1. $.each() 遍歷陣列</h3>
      <button id="btnEachArray">遍歷陣列 [10,20,30]</button>
      <button id="btnEachArrayBreak" class="secondary">遍歷並中斷 (index>1)</button>
      <div class="output" id="out1"></div>
    </div>
    
    <div class="demo-section">
      <h3>2. $.each() 遍歷物件 (JSON)</h3>
      <button id="btnEachObj">遍歷 {name:'Alice', age:25, city:'Taipei'}</button>
      <div class="output" id="out2"></div>
    </div>
    
    <div class="demo-section">
      <h3>3. $().each() 遍歷 jQuery 集合</h3>
      <ul id="demoList">
        <li data-id="1">蘋果</li>
        <li data-id="2">香蕉</li>
        <li data-id="3">橘子</li>
      </ul>
      <button id="btnEachJQ">遍歷 li 集合</button>
      <button id="btnEachJQBreak" class="secondary">遍歷並中斷 (id=2)</button>
      <div class="output" id="out3"></div>
    </div>
  </div>

  <script>
  $(function() {
    // 1. 陣列遍歷
    $('#btnEachArray').on('click', () => {
      const arr = [10, 20, 30];
      let out = '';
      $.each(arr, (i, val) => {
        out += `索引 ${i}: ${val}\n`;
      });
      $('#out1').text(out);
    });
    
    $('#btnEachArrayBreak').on('click', () => {
      const arr = [10, 20, 30];
      let out = '';
      $.each(arr, (i, val) => {
        if (i > 1) return false; // 中斷迴圈 (相當於 break)
        out += `索引 ${i}: ${val}\n`;
      });
      $('#out1').text(out + '--- 已中斷 ---');
    });

    // 2. 物件遍歷
    $('#btnEachObj').on('click', () => {
      const obj = {name: 'Alice', age: 25, city: 'Taipei'};
      let out = '';
      $.each(obj, (key, val) => {
        out += `${key}: ${val}\n`;
      });
      $('#out2').text(out);
    });

    // 3. jQuery 集合遍歷
    $('#btnEachJQ').on('click', () => {
      let out = '';
      $('#demoList li').each((i, el) => {
        const $el = $(el);
        out += `[${i}] ID: ${$el.data('id')}, 文字: ${$el.text()}, this.tagName: ${el.tagName}\n`;
      });
      $('#out3').text(out);
    });
    
    $('#btnEachJQBreak').on('click', () => {
      let out = '';
      $('#demoList li').each((i, el) => {
        if ($(el).data('id') === 2) return false; // 中斷
        out += `[${i}] ${$(el).text()}\n`;
      });
      $('#out3').text(out + '--- 在 id=2 處中斷 ---');
    });
  });
  </script>
</body>
</html>

核心細節深度解析

1. 中斷迴圈:return false = break,return true = continue

$.each(arr, (i, val) => {
  if (val === 20) return false; // 終止整個 each (break)
  if (val === 10) return true;  // 跳過本次迴圈 (continue)
  console.log(val);
});

這與原生 forEach 無法中斷形成鮮明對比。

2. this 指向差異

方法this 指向取值方式
$.each(obj, fn)value (原始值:字串/數字/物件)this 直接是值
$collection.each(fn)DOM 元素 (原生 element)this.tagName, $(this).data()
// 物件遍歷:this 是值 (基本類型會被包裝為包裝物件)
$.each({a:1}, function() { console.log(this); }); // Number {1}

// jQuery 集合:this 是 DOM 元素
$('#list li').each(function() { console.log(this); }); // 
  • ...
  • 3. 陣列 vs 類陣列 vs 物件

    // 陣列:按索引順序 0,1,2...
    $.each([10,20], fn); // i=0,1
    
    // 類陣列 (arguments, NodeList):按索引順序
    $.each(document.querySelectorAll('div'), fn); // i=0,1...
    
    // 物件:按鍵名順序 (現代瀏覽器保持插入順序)
    $.each({b:1, a:2}, fn); // key='b', key='a'

    4. 隱式 each:Setter 方法自動遍歷

    // 這些方法內部自動 each,無需手寫迴圈
    $('div').css('color', 'red');        // 為所有 div 設置顏色
    $('input').val('test');              // 為所有 input 設置值
    $('.item').addClass('active');       // 為所有 .item 添加類別
    $('img').attr('src', 'new.jpg');     // 為所有 img 設置 src

    進階模式與最佳實踐

    1. 陣列轉換:.map() vs .each()

    // 需要返回新陣列用 .map()
    const doubled = $numbers.map((i, el) => parseInt(el.value) * 2).get();
    
    // 只需副作用 (副作用:修改 DOM、發請求、日誌) 用 .each()
    $items.each((i, el) => {
      $(el).addClass('processed');
      saveToServer($(el).data('id'));
    });

    2. 非同步迴圈:each 不支援 await

    // ❌ 錯誤:each 不會等待 async 函數
    $.each(items, async (i, item) => {
      await api.save(item); // 併發執行,順序不可控
    });
    
    // ✅ 正確:for...of 配合 await
    for (const item of items) {
      await api.save(item); // 依序執行
    }
    
    // 或用 Promise.all 併發
    await Promise.all(items.map(item => api.save(item)));

    3. 效能:原生 for 迴圈 vs $.each()

    // 大量資料 (10萬+) 時,原生 for 快 10-50 倍
    for (let i = 0, len = arr.length; i < len; i++) { ... }
    
    // 現代語法也很快
    for (const item of arr) { ... }
    arr.forEach((item, i) => { ... }); // 無法中斷

    避坑指南

    ⚠ 常見錯誤:
    • 在 $.each(object) 中用 this.key 取鍵名 → this 是值,無 key 屬性,需用參數 key
    • 在 $().each() 中用 this.id 取 ID → this 是 DOM,直接 this.id 正確
    • 以為 return true 會返回結果 → 實為 continue,each() 返回原集合,無法自定義返回值
    • 箭頭函數中用 this → 箭頭函數無 this,必須用參數 (i, el) => ...

    總結

    • $.each(collection, fn):通用遍歷陣列/物件,this=value,支援 return false 中斷
    • $collection.each(fn):遍歷 jQuery 集合,this=DOM 元素,支援中斷
    • Setter 方法 (.css(), .val(), .attr()...) 內建隱式 each
    • 大量資料/非同步場景優先用原生 for...of / forEach / map
    • 記住 return false = break, return true = continue
    copyright © 萬盛學電腦網 all rights reserved