萬盛學電腦網

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

JavaScript 原生 appendChild 陷阱:動態搬移節點導致迴圈失效的正確解法

問題現象

嘗試將 `

    ` 下所有 `
  • ` 移動到 `
      `:

      const ul1 = document.getElementById('ul1');
      const ul2 = document.getElementById('ul2');
      const items = ul1.getElementsByTagName('li'); // HTMLCollection - 即時集合!
      
      for (let i = 0; i < items.length; i++) {
          ul2.appendChild(items[i]); // 錯誤!items.length 隨著搬移而減少
      }
      // 結果:只移動了第 0, 2, 4... 條(跳過奇數索引)

      根本原因

      • getElementsByTagName 回傳 **Live HTMLCollection**,即時反映 DOM 狀態。
      • appendChild 是**移動**節點而非複製,節點從 `ul1` 移除後,`items.length` 立即減 1,索引自動前移。
      • `for` 迴圈索引 `i` 遞增,導致跳過下一個元素。

      正確解法三種

      解法一:while 迴圈 + 固定取第一個 (推薦,最簡潔)

      const items = document.getElementById('ul1').getElementsByTagName('li');
      const target = document.getElementById('ul2');
      
      while (items.length) {
          target.appendChild(items[0]); // 永遠取第一個,集合自動縮減
      }

      解法二:先轉為靜態陣列

      const items = Array.from(document.getElementById('ul1').getElementsByTagName('li'));
      const target = document.getElementById('ul2');
      items.forEach(li => target.appendChild(li));

      解法三:反向迴圈 (適用於需保留順序的複製/操作)

      const items = document.getElementById('ul1').getElementsByTagName('li');
      const target = document.getElementById('ul2');
      for (let i = items.length - 1; i >= 0; i--) {
          target.appendChild(items[i]); // 從後往前移,索引不受影響
      }

      完整可執行 Demo

      <!DOCTYPE html>
      <html lang="zh-TW">
      <head>
          <meta charset="UTF-8">
          <title>appendChild 陷阱 Demo</title>
          <style>
              ul { border: 1px solid #ccc; min-height: 100px; padding: 1rem; margin: 1rem; display: inline-block; vertical-align: top; width: 200px; }
              li { background: #f0f0f0; margin: 4px 0; padding: 4px; cursor: grab; }
              button { margin: 1rem; padding: 0.5rem 1rem; }
          </style>
      </head>
      <body>
          <h3>點擊按鈕將左側列表項目移動到右側</h3>
          <ul id="ul1">
              <li>項目 1</li><li>項目 2</li><li>項目 3</li>
              <li>項目 4</li><li>項目 5</li><li>項目 6</li>
          </ul>
          <ul id="ul2"></ul>
          <br>
          <button id="btnWrong">錯誤寫法 (for 正向)</button>
          <button id="btnWhile">正確寫法 (while)</button>
          <button id="btnArray">正確寫法 (Array.from)</button>
          <button id="btnReverse">正確寫法 (反向 for)</button>
          <button id="btnReset">重置</button>
      
          <script>
              const ul1 = document.getElementById('ul1');
              const ul2 = document.getElementById('ul2');
              const originalHTML = ul1.innerHTML;
      
              function reset() { ul1.innerHTML = originalHTML; ul2.innerHTML = ''; }
      
              document.getElementById('btnWrong').onclick = () => {
                  reset();
                  const items = ul1.getElementsByTagName('li');
                  for (let i = 0; i < items.length; i++) ul2.appendChild(items[i]);
              };
      
              document.getElementById('btnWhile').onclick = () => {
                  reset();
                  const items = ul1.getElementsByTagName('li');
                  while (items.length) ul2.appendChild(items[0]);
              };
      
              document.getElementById('btnArray').onclick = () => {
                  reset();
                  Array.from(ul1.getElementsByTagName('li')).forEach(li => ul2.appendChild(li));
              };
      
              document.getElementById('btnReverse').onclick = () => {
                  reset();
                  const items = ul1.getElementsByTagName('li');
                  for (let i = items.length - 1; i >= 0; i--) ul2.appendChild(items[i]);
              };
      
              document.getElementById('btnReset').onclick = reset;
          </script>
      </body>
      </html>

      延伸:NodeList vs HTMLCollection

      特性HTMLCollectionNodeList (querySelectorAll)
      即時性Live (即時)Static (靜態快照)
      取得方式getElementsByTagName, childrenquerySelectorAll, childNodes
      forEach 支援否 (需 Array.from)是 (現代瀏覽器)
      appendChild 陷阱**有**無 (靜態)

      最佳實務: 操作 DOM 節點集合前,習慣用 Array.from() 或展開運算子 [...collection] 轉為靜態陣列,徹底避開 Live 集合陷阱,代碼更可預測、除錯更容易。

copyright © 萬盛學電腦網 all rights reserved