JS创建与删除DOM节点:createElement、appendChild及remove方法实战

作者:白露

时间:2026-10-30

浏览:366

深入详解 JavaScript 动态操作 DOM 节点的核心技术:通过 createElement、appendChild、remove 及 removeChild 完成节点的内存创建、文档挂载与安全删除,包含原理机制、性能优化与完整实战代码。

文章目录

在构建现代 Web 应用时,动态更新页面是极高频的需求。设想这样一个场景:在电商购物车或待办事项清单中,用户在输入框输入名称并点击“添加”按钮,页面无需刷新,立刻新增一行带有商品标题、单价和“删除”操作的卡片;当用户点击某项右侧的“删除”按钮时,该条目即刻从页面视图中移除。这一连串无缝交互的背后,本质上是 JavaScript 对 DOM(文档对象模型)树执行的节点增删操作:从内存中实例化元素、装配属性、挂载入文档流,以及在指定时机安全移出。本文将围绕 createElement、appendChild 与 remove 三大核心方法,深入梳理节点从诞生到销毁的全生命周期及实用避坑技巧。

一、创建 DOM 节点:document.createElement 的本质与内存机制

在 DOM 树中,所有的 HTML 标签最终都表现为一个 Node 实例。当需要向界面新增元素时,第一步并非直接在页面上“画”出内容,而是在 JavaScript 运行时内存中开辟一个新的元素对象。这正是 document.createElement() 的核心职责。

// 语法规范:传入有效的 HTML 标签名称(不区分大小写,规范推荐小写)
const newCard = document.createElement('div');
const title = document.createElement('h3');
const deleteBtn = document.createElement('button');

调用 document.createElement('div') 之后,浏览器在堆内存中生成了一个独立的 HTMLDivElement 对象。需要特别明确的是:此时该节点仅存在于内存中,尚未与当前页面的 document 树建立连接。这意味着无论你为它赋予何种样式、文字或尺寸,它都不会在屏幕上呈现,也绝对不会触发浏览器的回流(Reflow)或重绘(Repaint)。

离屏状态下的内容与属性装配

正因为离屏节点不触发任何渲染损耗,我们应当在节点挂载到页面前,集中把所需的 CSS 类名、内联样式、数据集属性(dataset)以及子元素一次性装配就绪:

  • 文本与内容注入:优先使用 textContent 填充纯文本,它具有极高的执行效率,且能天然杜绝 XSS 注入风险;若需要解析少量安全受控的结构,才使用 innerHTML。
  • 样式与标识:通过 classList.add('card-item') 配置 CSS 类,通过 id 或 dataset.id = '1001' 绑定业务数据键。
  • 事件监听挂载:可以在元素仍处于内存中时,直接通过 addEventListener 绑定交互逻辑。
JS创建与删除DOM节点:createElement、appendChild及remove方法实战
图 1:通过 createElement 在堆内存中完成节点创建与属性装配的标准步骤

二、挂载节点:appendChild 与 DOM 树连接

组装完成的离屏节点需要被插入到渲染树中才能被用户看见。最基础也是最经典的 API 便是 parentNode.appendChild(childNode)。

// 获取已存在于页面上的容器
const container = document.getElementById('card-list');

// 将离屏的新卡片挂载为 container 的最后一个子节点
const appendedNode = container.appendChild(newCard);

// 返回值:appendChild 会返回被成功追加的那个节点对象 (appendedNode === newCard 为 true)

不可忽视的“自动迁移”特性

初学者容易产生一个误区,认为 appendChild 会对传入的节点进行一次“复制”。实际上,在 DOM 规范中,一个 DOM Node 在文档树中必须具有且仅具有唯一的父节点与物理位置。

如果你将一个已经挂载在页面某处的现有节点再次作为参数传给另一个容器的 appendChild,浏览器不会创建副本,而是会先把该节点从原来的位置“拔除”,然后“插入”到新容器的末尾。这一行为等同于“剪切并粘贴”,是原生 DOM 移动节点的标准机制。如果你确实需要产生一份独立的新副本,必须显式调用 const clone = originalNode.cloneNode(true) 进行深拷贝。

JS创建与删除DOM节点:createElement、appendChild及remove方法实战
图 2:appendChild 的两类核心表现:全新节点追加与现有节点自动迁移

现代方法 append 与传统 appendChild 的异同

在现代 Web API(DOM Living Standard)中,除了 appendChild,还有一个更为灵活的 parent.append() 方法。二者存在以下关键差别:

  • 多参数支持:appendChild 严格只接受一个 Node 对象;而 append 允许传入多个参数,例如 parent.append(card1, card2, card3),能有效减少代码量。
  • 文本节点自动包装:如果向 append 传入普通字符串(如 parent.append('Hello')),它会自动将其包装为 DOM TextNode;而 appendChild 传入字符串会直接抛出类型错误。
  • 返回值:appendChild 返回传入的 Node;而 append 的返回值为 undefined。

三、删除 DOM 节点:remove 与 removeChild 及内存释放

当用户点击删除按钮,或者数据状态发生更新时,我们需要将对应的 DOM 节点从当前页面中移除。在 JavaScript 中,主要有两种实现途径:现代的自毁式 node.remove() 与传统的宿主式 parentNode.removeChild(node)。

1. 现代自毁式语法:element.remove()

自 DOM4 规范起引入的 remove() 是目前首选的删除方式。它直接由目标节点自身调用,无需手动去获取父节点:

// 获取要删除的元素
const targetCard = document.querySelector('.card-item[data-id="1001"]');

// 直接自毁,将其自身从所属父容器中彻底移出
targetCard.remove();

该语法语义极其清晰,完全避开了“先找父节点、再通过父节点删除自己”的繁琐链路。

2. 传统兼容语法:parent.removeChild(childNode)

如果需要在较旧的运行环境或特定封装中工作,可以使用经典做法:

// 需借助父节点进行协同操作
if (targetCard.parentNode) {
  const removedElement = targetCard.parentNode.removeChild(targetCard);
}

需要注意的是:removeChild 会将从 DOM 树中剔除的那个节点作为返回值交还给调用者。这在某些“取出节点并在别处重新挂载”的场景下十分有用。

重要认知:从 DOM 树移除 ≠ 内存彻底销毁

调用 remove() 或 removeChild() 仅代表将节点从浏览器的文档渲染树中剥离,用户在界面上不再可见。但是,如果 JavaScript 代码中(例如某个全局变量、数组、闭包或未解绑的监听器中)依然保留着对该节点的引用,那么这个节点就会演变为游离 DOM(Detached DOM),继续驻留在堆内存中,无法被垃圾回收器(GC)清理,从而埋下内存泄漏的隐患。

JS创建与删除DOM节点:createElement、appendChild及remove方法实战
图 3:DOM 节点移除后的两条不同内存路径(游离滞留与垃圾回收释放)

四、综合实战:动态待办任务项增删完整实现

下面我们将上述的 createElement、appendChild、样式类装配、防 XSS 策略以及 remove 自毁逻辑串联在一起,构建一个功能完整、具备生产级健壮性的待办任务增删模块。

// 1. 初始化容器与输入控件
const taskInput = document.getElementById('task-input');
const addBtn = document.getElementById('add-btn');
const taskList = document.getElementById('task-list');

// 2. 核心创建函数:负责在内存中制造出符合规格的独立任务节点
function createTaskItem(taskContent, taskId) {
  // 步骤 A: 创建外层 li 容器
  const li = document.createElement('li');
  li.className = 'task-item';
  li.dataset.id = taskId;

  // 步骤 B: 创建内容 span(采用 textContent 杜绝 XSS)
  const textSpan = document.createElement('span');
  textSpan.className = 'task-text';
  textSpan.textContent = taskContent;

  // 步骤 C: 创建删除按钮并绑定专属自毁事件
  const deleteBtn = document.createElement('button');
  deleteBtn.className = 'btn-delete';
  deleteBtn.textContent = '删除';

  deleteBtn.addEventListener('click', function(event) {
    // 阻止可能的外层事件冒泡
    event.stopPropagation();
    
    // 执行自毁删除:将当前 li 节点直接从 DOM 树移除
    li.remove();
    console.log(`任务 ${taskId} 已从 DOM 移除`);
  });

  // 步骤 D: 离屏组装子结构(尚未插入文档流,无重排损耗)
  li.appendChild(textSpan);
  li.appendChild(deleteBtn);

  return li;
}

// 3. 点击“添加”按钮的交互响应
addBtn.addEventListener('click', function() {
  const content = taskInput.value.trim();
  if (!content) {
    alert('请输入任务内容');
    return;
  }

  const newId = Date.now().toString();
  // 实例化内存节点
  const itemNode = createTaskItem(content, newId);

  // 一次性挂载入页面 DOM 树
  taskList.appendChild(itemNode);

  // 清空输入框并重新聚焦
  taskInput.value = '';
  taskInput.focus();
});

在此示例中,createTaskItem 函数始终保持职责单一:只负责在内存中实例化元素、绑定事件并拼接结构。外部的点击事件监听器只负责将就绪后的离屏节点通过 appendChild 单次推入页面,逻辑解耦且性能优秀。

五、进阶优化:性能陷阱与高频避坑指南

当页面需要操作的节点数量从几个增加到成百上千个时,初学者若使用不当,极易引发页面掉帧或内存溢出。以下是开发中必须警惕的三大性能陷阱:

1. 警惕循环内频繁 appendChild 引发“布局抖动”

如果需要一次性向列表追加 500 个条目,千万不要在 for 循环中每一次迭代都直接调用 container.appendChild(item)。因为每次将新节点挂上真实文档树,浏览器都有可能重新计算元素的几何属性(Reflow 回流),导致严重的性能损耗。

解决方案:使用 DocumentFragment(文档片段)

// 创建一个虚拟的轻量级离屏容器
const fragment = document.createDocumentFragment();

dataList.forEach(data => {
  const item = document.createElement('li');
  item.textContent = data.title;
  // 先全部挂入内存中的 fragment,不引发任何浏览器回流
  fragment.appendChild(item);
});

// 循环结束后,仅需执行单次真实 DOM 挂载
container.appendChild(fragment);

DocumentFragment 在被 appendChild 挂载时,自身并不会进入页面,而是将其包含的所有子节点一次性“倾倒”进目标容器中,从而将数百次回流强力压缩为仅此 1 次。

2. 谨慎混用 innerHTML += 导致已有事件全量失效

有些开发者为了省事,习惯使用 container.innerHTML += '<li>新内容</li>'。这种写法非常危险,因为 += 的实质是先将容器内现存的所有子节点序列化为 HTML 字符串,拼接后再重新解析生成全新的 DOM 树并替换。这不仅带来巨大的解析开销,更会导致此前已经绑定在所有已有节点上的事件监听器全部丢失,输入框中的未提交内容也会被重置。

3. 大量列表项推荐采用“事件委托”

在上面的实战示例中,我们在每个任务的“删除”按钮上独立绑定了 addEventListener。如果列表有成千上万条,就会产生海量事件监听闭包,占用较多内存。更高级的做法是将点击监听绑定在父容器 taskList 上,借助事件冒泡机制根据 event.target 统一调度处理,从而将事件监听器精简为 1 个。

六、知识全景:DOM 增删及相关 API 决策速查

为了在实际工程中迅速选择最合适的 DOM 操作方案,下表梳理了与创建、挂载、删除相关的核心 API 及其最佳使用场景:

操作阶段 核心 API 语法示例 优势与推荐场景
节点创建 document.createElement document.createElement('div') 最常用的元素创建方法,属性可精确配置,纯内存操作。
document.createDocumentFragment document.createDocumentFragment() 虚拟离屏容器,批量插入多节点时的首选性能神器。
节点挂载 parentNode.appendChild parent.appendChild(el) 经典标准 API,追加单节点至尾部,返回被添加的节点对象。
parentNode.append parent.append(el1, '文本', el2) 现代规范,支持一次性追加多项及直接混排字符串。
parentNode.insertBefore parent.insertBefore(newNode, refNode) 需要将节点精准插入到某个指定子元素之前时使用。
节点删除 element.remove el.remove() 现代推荐做法,自身直接自毁脱离父容器,语法最为凝练。
parentNode.removeChild parent.removeChild(el) 传统兼容做法,需通过父节点删除子节点,返回被移除的节点。
JS创建与删除DOM节点:createElement、appendChild及remove方法实战
图 4:DOM 节点全生命周期常用 API 决策与避坑指南速查图

掌握 createElement 的离屏组装、appendChild 的挂载与位置迁移规则,以及 remove 的自毁解绑与垃圾回收机制,是构建高响应度、无内存泄漏原生前端应用的基石。在日后的项目开发中,结合 DocumentFragment 批处理和事件委托,可以从容应对复杂高频的 DOM 节点交互场景。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章