浏览器与 Web API / 系统课时
批量更新与 DocumentFragment
批量更新与 DocumentFragment
频繁向在线 DOM 逐个插入节点,会让页面在中间状态中反复处理结构变化。本课通过 DocumentFragment 先离线组装列表,再一次性提交到真实容器,并配合类名切换完成可验证的批量更新。
学习目标
- 理解
DocumentFragment作为临时节点容器的作用。 - 使用离线构建、一次提交和
replaceChildren()更新列表。 - 将 DOM 读取与写入分批,避免循环中的重复布局检查。
为什么要把更新分成批次
直接在循环中不断修改在线 DOM,会产生许多可观察的中间状态,也更容易把尺寸读取、样式写入和节点插入混在一起。浏览器可能推迟部分工作,但代码仍会增加样式计算、布局依赖和维护复杂度,尤其在列表较大或每次插入后又读取几何信息时。

DocumentFragment 是轻量的临时容器。节点可以先追加到其中,等结构准备完成后再整体插入真实 DOM。插入时移动的是它的子节点,片段本身不会成为页面中的额外包裹层;提交完成后,片段会变为空。
批量构建并一次提交
下面示例生成 1000 条任务。所有 li 先进入片段,随后由 replaceChildren() 一次替换列表内容;页面状态和高亮样式也在提交后统一更新。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>DocumentFragment 批量更新</title>
<style>
body {
font-family: sans-serif;
}
#taskList {
max-height: 280px;
overflow: auto;
padding: 12px 28px;
border: 1px solid #cbd5e1;
}
#taskList.is-ready {
background: #f0fdf4;
}
</style>
</head>
<body>
<button id="renderButton">批量渲染 1000 项</button>
<p id="status">等待渲染</p>
<ul id="taskList"></ul>
<script>
const renderButton = document.querySelector('#renderButton');
const status = document.querySelector('#status');
const taskList = document.querySelector('#taskList');
// 先生成稳定数据,渲染函数只负责把数据转换为节点。
function createTasks(count) {
return Array.from({ length: count }, (_, index) => ({
id: index + 1,
title: `任务 ${index + 1}`
}));
}
function renderTasks(tasks) {
const fragment = document.createDocumentFragment();
// 离线创建节点,循环期间不修改在线列表。
for (const task of tasks) {
const item = document.createElement('li');
item.dataset.id = String(task.id);
item.textContent = task.title;
fragment.append(item);
}
// 一次提交全部子节点,片段随后自动变为空。
taskList.replaceChildren(fragment);
taskList.classList.toggle('is-ready', tasks.length > 0);
status.textContent = `已渲染 ${taskList.children.length} 项`;
console.log(status.textContent);
console.log(`片段剩余节点:${fragment.childNodes.length}`);
}
// 用户操作只触发一次完整的批量渲染。
renderButton.addEventListener('click', () => {
renderTasks(createTasks(1000));
});
</script>
</body>
</html>预期输出
页面状态显示:已渲染 1000 项
控制台输出:已渲染 1000 项
控制台输出:片段剩余节点:0
列表背景变为浅绿色,最终 DOM 中直接包含 1000 个 li。replaceChildren() 适合用新内容完整替换容器;若需要保留既有节点,可改用 append(fragment)。无论选择哪种提交方式,都应避免在创建循环中读取 offsetHeight、getBoundingClientRect() 等几何属性,否则离线构建的优势会被后续读写交错削弱。
类名切换与读写分组
批量更新不只针对节点插入。多个视觉状态应尽量通过类名集中表达,而不是逐条写入许多行内样式。需要测量时,先读取所有元素尺寸并保存到数组,再在下一批操作中修改类名或样式;复杂动画还可以把写入放进 requestAnimationFrame(),让变更更接近下一帧统一执行。
应同时避免把 DocumentFragment 神化。现代浏览器会合并部分 DOM 工作,片段不保证在所有场景中显著加速;它更稳定的价值是减少中间状态、明确“构建”和“提交”的边界,并让代码更容易检查与复用。