語法與參數
parentNode.replaceChild(newChild, oldChild)
- newChild:要插入的新節點。
- oldChild:要被替換的現有子節點。
- 回傳值:被替換的舊節點(可用於後續操作或釋放記憶體)。
基本範例:替換第一個與最後一個子元素
<div id="guoDiv">
<span>1</span>
<span>2</span>
<span>3</span>
</div>
<script>
var oDiv = document.getElementById("guoDiv");
// 取得第一個子元素(相容 IE8- 不支援 firstElementChild)
var firstChild = oDiv.firstElementChild || oDiv.firstChild;
// 建立新節點
var oSpan = document.createElement("span");
oSpan.innerHTML = "4";
// 執行替換
var returnedNode = oDiv.replaceChild(oSpan, firstChild);
console.log("被替換的節點內容:", returnedNode.innerHTML); // "1"
// 替換最後一個
var lastChild = oDiv.lastElementChild || oDiv.lastChild;
oSpan = document.createElement("span");
oSpan.innerHTML = "5";
returnedNode = oDiv.replaceChild(oSpan, lastChild);
console.log("被替換的節點內容:", returnedNode.innerHTML); // "3"
</script>
常見應用場景
| 場景 | 說明 |
| 動態更新列表項目 | 替換特定 <li> 而不重渲染整個列表 |
| 表單驗證提示切換 | 將錯誤訊息節點替換為成功圖示 |
| 元件熱切換 | 在相同容器位置切換不同 UI 元件 |
| 虛擬 DOM Diff 算法 | React/Vue 等框架核心邏輯即基於節點替換 |
注意事項
- 新節點若已存在於文檔中,會先從原位置移除(自動移動)。
- 若
oldChild 非 parentNode 子節點,會拋出 NotFoundError。
- 替換後舊節點仍存在於記憶體,若無其他引用將被 GC 回收。
- 文字節點也可被替換:
parent.replaceChild(document.createTextNode("新文字"), oldTextNode)。
相關節點操作方法速查
| 方法 | 用途 | 回傳值 |
appendChild(node) | 新增子節點至末尾 | 新增的節點 |
insertBefore(new, ref) | 在參考節點前插入 | 新增的節點 |
removeChild(node) | 移除子節點 | 被移除的節點 |
replaceChild(new, old) | 替換子節點 | 被替換的節點 |
cloneNode(deep) | 複製節點 | 複製的節點 |