浏览器与 Web API / 系统课时

创建文本节点与文档片段

创建文本节点与文档片段

本课解决两个常见问题:如何显式创建安全的文本节点,以及如何先在内存中批量组装多个节点再一次性插入页面。完成后,你将能正确使用 createTextNode() 和 DocumentFragment 构建列表结构。

学习目标

  • 使用 document.createTextNode() 创建纯文本节点
  • 理解 DocumentFragment 作为临时节点容器的工作方式
  • 能批量构建并插入多个 DOM 节点

两种节点的职责

document.createTextNode(text) 返回一个 Text 节点。传入内容始终被当作普通文本,不会解析其中的 HTML 标签,因此适合插入用户输入、接口返回文本或需要明确控制节点类型的内容。

对于简单元素,直接设置 element.textContent 通常更简洁。需要在同一个元素中混合文字与其他子元素,或者需要保留并操作独立文本节点时,createTextNode() 更合适。

DocumentFragment 是一个轻量级临时容器,可以容纳多个节点,但它本身不会作为可见标签出现在页面中。常见创建方式是 document.createDocumentFragment()。

把片段插入真实 DOM 时,浏览器会把片段中的子节点依次移动到目标位置,片段自身不会被插入。插入完成后,片段会变空,这一点与普通容器元素不同。

DocumentFragment 批量组装与插入过程

完整示例:批量创建课程列表

下面的完整页面使用文本节点构建每个列表项,再通过文档片段一次性加入列表。控制台用于验证片段插入前后的子节点数量。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>DocumentFragment 示例</title>
</head>
<body>
  <ul id="course-list"></ul>

  <script>
    const courses = ["DOM 查询", "节点遍历", "事件处理"];
    const courseList = document.querySelector("#course-list");
    const fragment = document.createDocumentFragment();

    for (const course of courses) {
      const item = document.createElement("li");
      const textNode = document.createTextNode(course);

      // 文本节点先进入 li,li 再进入临时片段
      item.append(textNode);
      fragment.append(item);
    }

    console.log("插入前片段子节点数:", fragment.childNodes.length);

    // 插入时移动片段中的子节点,片段本身不会进入页面
    courseList.append(fragment);

    console.log("插入后片段子节点数:", fragment.childNodes.length);
    console.log("列表项数量:", courseList.children.length);
  </script>
</body>
</html>

预期结果

text
页面显示三个列表项:
DOM 查询
节点遍历
事件处理

控制台输出:
插入前片段子节点数: 3
插入后片段子节点数: 0
列表项数量: 3

浏览器控制台的空格样式可能不同,但三个数值应依次为 3、0、3。

选择方式与关键边界

只需要为一个元素设置完整纯文本时,textContent 更短,也更容易阅读。需要把文本放在指定子节点位置、与多个元素交错组合,或保留文本节点引用时,选择 createTextNode()。

两种方式都不会把字符串解析为 HTML。不要为了“更安全”而机械地把所有文字都改成文本节点;应根据结构是否需要独立节点来决定。

DocumentFragment 适合临时组装一批待插入节点,不是永久缓存。片段中的节点进入真实 DOM 后会从片段移走,因此不能再次追加同一个空片段来复制内容。若需要复制结构,可重新构建片段,或对已有节点使用 cloneNode(true),并重新绑定必要的事件。

批量插入的主要价值是让构建过程更集中、代码结构更清晰,并减少多次直接修改目标容器。性能是否明显提升取决于页面规模、浏览器优化和是否触发布局读取,不应把片段视为所有场景下的性能保证。

验证时可同时检查页面列表项数量、fragment.childNodes.length 和目标容器的 children.length,从而确认节点确实被移动而非复制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建文本节点与文档片段

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通