浏览器与 Web API / 系统课时
创建文本节点与文档片段
创建文本节点与文档片段
本课解决两个常见问题:如何显式创建安全的文本节点,以及如何先在内存中批量组装多个节点再一次性插入页面。完成后,你将能正确使用 createTextNode() 和 DocumentFragment 构建列表结构。
学习目标
- 使用
document.createTextNode()创建纯文本节点 - 理解
DocumentFragment作为临时节点容器的工作方式 - 能批量构建并插入多个 DOM 节点
两种节点的职责
document.createTextNode(text) 返回一个 Text 节点。传入内容始终被当作普通文本,不会解析其中的 HTML 标签,因此适合插入用户输入、接口返回文本或需要明确控制节点类型的内容。
对于简单元素,直接设置 element.textContent 通常更简洁。需要在同一个元素中混合文字与其他子元素,或者需要保留并操作独立文本节点时,createTextNode() 更合适。
DocumentFragment 是一个轻量级临时容器,可以容纳多个节点,但它本身不会作为可见标签出现在页面中。常见创建方式是 document.createDocumentFragment()。
把片段插入真实 DOM 时,浏览器会把片段中的子节点依次移动到目标位置,片段自身不会被插入。插入完成后,片段会变空,这一点与普通容器元素不同。

完整示例:批量创建课程列表
下面的完整页面使用文本节点构建每个列表项,再通过文档片段一次性加入列表。控制台用于验证片段插入前后的子节点数量。
<!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>预期结果
页面显示三个列表项:
DOM 查询
节点遍历
事件处理
控制台输出:
插入前片段子节点数: 3
插入后片段子节点数: 0
列表项数量: 3浏览器控制台的空格样式可能不同,但三个数值应依次为 3、0、3。
选择方式与关键边界
只需要为一个元素设置完整纯文本时,textContent 更短,也更容易阅读。需要把文本放在指定子节点位置、与多个元素交错组合,或保留文本节点引用时,选择 createTextNode()。
两种方式都不会把字符串解析为 HTML。不要为了“更安全”而机械地把所有文字都改成文本节点;应根据结构是否需要独立节点来决定。
DocumentFragment 适合临时组装一批待插入节点,不是永久缓存。片段中的节点进入真实 DOM 后会从片段移走,因此不能再次追加同一个空片段来复制内容。若需要复制结构,可重新构建片段,或对已有节点使用 cloneNode(true),并重新绑定必要的事件。
批量插入的主要价值是让构建过程更集中、代码结构更清晰,并减少多次直接修改目标容器。性能是否明显提升取决于页面规模、浏览器优化和是否触发布局读取,不应把片段视为所有场景下的性能保证。
验证时可同时检查页面列表项数量、fragment.childNodes.length 和目标容器的 children.length,从而确认节点确实被移动而非复制。