要把頁面上某個節點換成另一個,DOM 提供了 replaceChild()。它的呼叫方式有個容易搞錯的地方:必須站在父節點的角度呼叫,並把「新」與「舊」兩個節點都傳進去。
parent.replaceChild(新, 舊)。
<html>
<head>
<script type="text/javascript">
function t(){
// 1. 建立新節點
var newli = document.createElement('li');
var newtext = document.createTextNode('白天');
newli.appendChild(newtext);
// 2. 找到父節點與要替換的舊節點
var nodeul = document.getElementsByTagName('ul')[0];
var oldli = nodeul.children[2];
// 3. 在父節點的角度執行替換
nodeul.replaceChild(newli, oldli);
}
</script>
</head>
<body>
<div id="container">
<ul>
<li>春天</li>
<li>夏天</li>
<li>藍天</li>
<li>秋天</li>
<li>冬天</li>
</ul>
</div>
<hr />
<button onclick="t()">節點的替換與修改</button>
</body>
</html>
點擊後第三個項目「藍天」會被換成「白天」。
oldNode = parentNode.replaceChild(newNode, oldChild);
它會回傳被換掉的那個舊節點。這個回傳值很實用,讓你可以先把舊節點存起來,之後再換回去:
var saved = ul.replaceChild(newLi, oldLi); // ...稍後還原 ul.replaceChild(saved, newLi);
新舊節點必須有共同的父節點:newChild 與 oldChild 都必須是該父節點的直接子節點,否則會丟出 NotFoundError。
新節點若已在文件上會被搬移:replaceChild 不會複製,而是把 newChild 從原本的位置移過來。若要保留原處,先 cloneNode(true)。
children 與 childNodes 不同:範例用 nodeul.children[2] 只會取得元素節點;childNodes[2] 則會把空白文字節點也計算在內,在 HTML 有換行縮排的情況下很容易取錯。要選元素請優先用 children。
今天有更直觀的方法可以完成同樣的事:
// 寫法一:replaceWith(在舊節點自己身上呼叫) oldLi.replaceWith(newLi); // 寫法二:replaceChildren(一次換掉全部子節點) ul.replaceChildren(newLi, anotherLi); // 寫法三:用 outerHTML 直接換掉整段(但會重建節點) oldLi.outerHTML = '<li>白天</li>';
replaceWith() 的語意最清楚——「我這個節點要被換成那個」,不必先找父節點,程式碼短很多。而 replaceChildren() 則一次清空並填入多個新子節點,比迴圈 removeChild + appendChild 乾淨得多。
若替換的是使用者互動的元素,記得替換後要重新綁定事件,或改用事件委派掛在共同祖先上,這樣就不必理會子節點被換掉多少次。