前言
動態操作 DOM 節點 (建立、插入、移除、替換) 是前端開發的核心技能。本文系統整理原生 JS 與 jQuery 的各種節點操作模式,特別釐清「移除子節點」的常見誤區與最佳實踐。
建立節點的三種主流方式
1. document.createElement (標準、效能最佳)
// 建立元素節點
const li = document.createElement('li');
li.className = 'item';
li.dataset.id = 123;
// 建立文字節點
const text = document.createTextNode('項目內容');
// 組裝
li.appendChild(text);
document.getElementById('list').appendChild(li);
2. innerHTML 字串拼接 (簡潔、適合批量)
const items = ['蘋果', '香蕉', '橘子'];
const html = items.map(item => `${escapeHtml(item)}`).join('');
document.getElementById('list').innerHTML = html;
// 簡易 XSS 防護
function escapeHtml(str) {
return str.replace(/[&<>"']/g, c => ({
'&': '&', '<': '<', '>': '>', '"': '"', "'": '''
})[c]);
}
3. DocumentFragment (大量節點插入效能優化)
const fragment = document.createDocumentFragment();
const list = document.getElementById('list');
for (let i = 0; i < 1000; i++) {
const li = document.createElement('li');
li.textContent = `項目 ${i}`;
fragment.appendChild(li); // 離線操作,不觸發重繪
}
list.appendChild(fragment); // 單次觸發重繪
移除子節點:四種核心方法比較
| 方法 | 語法 | 回傳值 | 適用場景 | 效能 |
| innerHTML = '' |
parent.innerHTML = '' |
undefined |
一次性清空所有子節點、不需要參考被刪除節點 |
⭐⭐⭐⭐⭐ (最快) |
| removeChild() |
parent.removeChild(child) |
被移除的節點 |
需保留被刪節點參考、條件式移除特定子節點 |
⭐⭐⭐ |
| remove() |
child.remove() |
undefined |
現代瀏覽器、直接在子節點上呼叫、程式碼可讀性佳 |
⭐⭐⭐⭐ |
| replaceChildren() |
parent.replaceChildren(...nodes) |
undefined |
一次性替換所有子節點 (現代瀏覽器) |
⭐⭐⭐⭐⭐ |
範例:條件式移除特定子節點
const ul = document.getElementById('list');
// 方法一:反向迴圈 removeChild (避免索引偏移)
for (let i = ul.children.length - 1; i >= 0; i--) {
const li = ul.children[i];
if (li.dataset.status === 'deleted') {
ul.removeChild(li); // 或 li.remove()
}
}
// 方法二:轉陣列 filter + remove (現代、可讀性佳)
[...ul.children]
.filter(li => li.dataset.status === 'deleted')
.forEach(li => li.remove());
// 方法三:TreeWalker 遍歷大量節點 (極大量時效能優)
const walker = document.createTreeWalker(ul, NodeFilter.SHOW_ELEMENT, {
acceptNode: node => node.dataset.status === 'deleted' ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP
});
const toRemove = [];
while (walker.nextNode()) toRemove.push(walker.currentNode);
toRemove.forEach(n => n.remove());
jQuery 方式 (舊專案維護)
// 清空所有子節點 (含事件清理、資料清理)
$('#list').empty();
// 等同於 $('#list').html('') 但會清理 jQuery 內部資料快取
// 移除特定子節點
$('#list li.deleted').remove(); // 移除自身
$('#list').find('li.deleted').remove(); // 同義
// 移除但保留資料/事件 (極少用)
$('#list li.deleted').detach();
記憶體洩漏防範關鍵點
- 事件處理器:使用
innerHTML = '' 或 .empty() 時,若子節點有直接綁定事件 (非委派),**必須先移除事件**,否則舊版 IE 會洩漏,現代瀏覽器 GC 通常能處理但仍建議明確清理
- jQuery 資料快取:
.remove() / .empty() 會自動清理 .data() 快取,.detach() 保留
- 循環引用:JS 物件持有 DOM 參考,DOM 透過事件/屬性持有 JS 物件 → 手動斷開
element.handler = null
現代最佳實踐模板
class ListManager {
constructor(containerSelector) {
this.$container = document.querySelector(containerSelector);
this.fragment = document.createDocumentFragment();
}
// 批量新增
addItems(items) {
items.forEach(item => {
const el = this.createItemElement(item);
this.fragment.appendChild(el);
});
this.$container.appendChild(this.fragment);
}
// 條件移除
removeItems(predicate) {
const toRemove = [...this.$container.children].filter(predicate);
toRemove.forEach(el => {
this.cleanupElement(el); // 自定義清理: 事件、定時器、觀察器等
el.remove();
});
}
// 清空
clear() {
[...this.$container.children].forEach(el => this.cleanupElement(el));
this.$container.innerHTML = ''; // 最快
}
createItemElement(item) {
const li = document.createElement('li');
li.dataset.id = item.id;
li.textContent = item.name;
// 事件委派到容器,單一元素無需個別綁定
return li;
}
cleanupElement(el) {
// 移除直接綁定的事件 (若有)
// 清除定時器、IntersectionObserver、ResizeObserver 等
el.removeEventListener('click', el._clickHandler);
}
}
常見錯誤避雷
| 錯誤代碼 | 問題 | 修正 |
for(let i=0; i |
即時移除導致 children 長度變化,索引偏移漏刪 |
反向迴圈、或先收集陣列再迴圈、或 while(firstChild) remove() |
parent.innerHTML = '' 後嘗試使用舊子節點參考 |
節點已從文檔移除,但變數仍持有參考 (記憶體洩漏風險) |
移除前清理參考,或改用 removeChild 取得回傳值 |
大量迴圈中反覆 appendChild |
每次觸發重排重繪,嚴重效能問題 |
使用 DocumentFragment 或字串拼接後單次 innerHTML |
總結
- 批量建立:
DocumentFragment 或 innerHTML (注意 XSS)
- 清空容器:
parent.innerHTML = '' (最快) 或 parent.replaceChildren() (現代)
- 條件移除:
[...children].filter(...).forEach(el => el.remove()) (可讀性最佳)
- 需保留節點:
parent.removeChild(child) 取得回傳值
- 記憶體安全:移除前清理事件、定時器、觀察器、資料快取