萬盛學電腦網

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

JavaScript 動態建立與移除子節點完整指南

前言

動態操作 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) 取得回傳值
    • 記憶體安全:移除前清理事件、定時器、觀察器、資料快取
    copyright © 萬盛學電腦網 all rights reserved