萬盛學電腦網

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

DOM insertBefore() 在指定位置插入節點完整教學

DOM insertBefore() 精準插入節點核心指南

parentNode.insertBefore(newNode, referenceNode) 在參考節點之前插入新節點。若 referenceNode 為 null,等同 appendChild (插到末尾)。這是構建有序列表、插入排序、動態表單的基礎操作。

語法與參數

parent.insertBefore(newNode, referenceNode);

// newNode: 要插入的節點 (Element, Text, DocumentFragment 等)
// referenceNode: 參考節點,新節點將插在它之前
// 返回值: 插入的新節點

完整演示代碼

<html>
<head>
  <script>
    function insertAtPosition() {
      // 1. 創建新節點
      const newLi = document.createElement('li');
      const text = document.createTextNode('藍天');
      newLi.appendChild(text);
      
      // 2. 獲取父容器與參考節點
      const ul = document.getElementsByTagName('ul')[0];
      const refLi = ul.getElementsByTagName('li')[2]; // 第3個 li (秋天)
      
      // 3. 在參考節點前插入
      ul.insertBefore(newLi, refLi);
      // 結果: 春天, 夏天, 藍天(新), 秋天, 冬天
    }
  </script>
</head>
<body>
  <div id="container">
    <ul>
      <li>春天</li>
      <li>夏天</li>
      <li>秋天</li>
      <li>冬天</li>
    </ul>
  </div>
  <button onclick="insertAtPosition()">指定位置插入節點</button>
</body>
</html>

關鍵特性與邊界情況

場景行為說明
referenceNode = null等同 appendChild插入到子節點列表末尾
newNode 已在文檔中先移除再插入 (移動)不會複製,保留事件/數據
referenceNode 非子節點拋出 DOMException必須是 parent 的直接子節點
插入 DocumentFragment片段內所有節點依序插入片段本身不進入文檔,高效批量插入

實戰:有序插入 (按字母排序)

function insertSorted(parent, newNode, getText) {
  const children = [...parent.children];
  const newText = getText(newNode);
  
  // 找到第一個大於新節點的元素
  const refNode = children.find(child => getText(child) > newText);
  
  parent.insertBefore(newNode, refNode || null);
}

// 使用
const ul = document.getElementById('sorted-list');
const newItem = document.createElement('li');
newItem.textContent = '藍天';
insertSorted(ul, newItem, el => el.textContent);

insertBefore vs appendChild vs prepend

// 末尾插入
parent.appendChild(newNode);
parent.insertBefore(newNode, null);

// 開頭插入
parent.insertBefore(newNode, parent.firstChild);
// 現代 API
parent.prepend(newNode); // 支持多參數

// 指定位置
parent.insertBefore(newNode, referenceNode);

現代替代:Node.insertBefore() 仍是標準

雖有 prepend()、append()、before()、after() (ChildNode 方法),但 insertBefore() 仍是唯一支持「在任意中間位置插入」的原生標準方法,無 Polyfill 也能在 IE6+ 工作。

jQuery 等價操作

// jQuery
$(referenceNode).before(newNode);  // 之前
$(referenceNode).after(newNode);   // 之後
$(parent).prepend(newNode);        // 內部開頭
$(parent).append(newNode);         // 內部末尾

精通 insertBefore 的參考節點機制,是掌握 DOM 動態構建的核心技能之一。

copyright © 萬盛學電腦網 all rights reserved