浏览器与 Web API / 系统课时

批量更新与 DocumentFragment

批量更新与 DocumentFragment

频繁向在线 DOM 逐个插入节点,会让页面在中间状态中反复处理结构变化。本课通过 DocumentFragment 先离线组装列表,再一次性提交到真实容器,并配合类名切换完成可验证的批量更新。

学习目标

  • 理解 DocumentFragment 作为临时节点容器的作用。
  • 使用离线构建、一次提交和 replaceChildren() 更新列表。
  • 将 DOM 读取与写入分批,避免循环中的重复布局检查。

为什么要把更新分成批次

直接在循环中不断修改在线 DOM,会产生许多可观察的中间状态,也更容易把尺寸读取、样式写入和节点插入混在一起。浏览器可能推迟部分工作,但代码仍会增加样式计算、布局依赖和维护复杂度,尤其在列表较大或每次插入后又读取几何信息时。

DocumentFragment 离线构建与一次提交

DocumentFragment 是轻量的临时容器。节点可以先追加到其中,等结构准备完成后再整体插入真实 DOM。插入时移动的是它的子节点,片段本身不会成为页面中的额外包裹层;提交完成后,片段会变为空。

批量构建并一次提交

下面示例生成 1000 条任务。所有 li 先进入片段,随后由 replaceChildren() 一次替换列表内容;页面状态和高亮样式也在提交后统一更新。

html
<!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>

预期输出

text
页面状态显示:已渲染 1000 项
控制台输出:已渲染 1000 项
控制台输出:片段剩余节点:0
列表背景变为浅绿色,最终 DOM 中直接包含 1000 个 li。

replaceChildren() 适合用新内容完整替换容器;若需要保留既有节点,可改用 append(fragment)。无论选择哪种提交方式,都应避免在创建循环中读取 offsetHeight、getBoundingClientRect() 等几何属性,否则离线构建的优势会被后续读写交错削弱。

类名切换与读写分组

批量更新不只针对节点插入。多个视觉状态应尽量通过类名集中表达,而不是逐条写入许多行内样式。需要测量时,先读取所有元素尺寸并保存到数组,再在下一批操作中修改类名或样式;复杂动画还可以把写入放进 requestAnimationFrame(),让变更更接近下一帧统一执行。

应同时避免把 DocumentFragment 神化。现代浏览器会合并部分 DOM 工作,片段不保证在所有场景中显著加速;它更稳定的价值是减少中间状态、明确“构建”和“提交”的边界,并让代码更容易检查与复用。

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

目录与阅读设置

阅读设置

17

记录一个想法

批量更新与 DocumentFragment

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

登录哪都通