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);
// 末尾插入
parent.appendChild(newNode);
parent.insertBefore(newNode, null);
// 開頭插入
parent.insertBefore(newNode, parent.firstChild);
// 現代 API
parent.prepend(newNode); // 支持多參數
// 指定位置
parent.insertBefore(newNode, referenceNode);
雖有 prepend()、append()、before()、after() (ChildNode 方法),但 insertBefore() 仍是唯一支持「在任意中間位置插入」的原生標準方法,無 Polyfill 也能在 IE6+ 工作。
// jQuery
$(referenceNode).before(newNode); // 之前
$(referenceNode).after(newNode); // 之後
$(parent).prepend(newNode); // 內部開頭
$(parent).append(newNode); // 內部末尾
精通 insertBefore 的參考節點機制,是掌握 DOM 動態構建的核心技能之一。