萬盛學電腦網

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

JavaScript replaceChild() 替換 DOM 節點完整教學

語法與參數

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)複製節點複製的節點
copyright © 萬盛學電腦網 all rights reserved