浏览器与 Web API / 系统课时

使用 data 属性关联数据项

使用 data 属性关联数据项

列表节点被点击时,事件处理器需要知道它代表哪条业务记录。本课使用 data-id 在 DOM 中保存最小标识,再通过 dataset 取回编号并定位原始数据,完成可靠的状态更新。

学习目标

  • 理解为什么 DOM 中应保存记录标识,而不是复制完整业务对象。
  • 掌握 data-*、dataset、closest() 与数组查找的组合用法。
  • 能处理字符串类型、无效标识和事件目标越界等边界情况。

从 DOM 标识回到数据源

data-id 的职责是建立“节点与记录”的关联。页面渲染时把稳定且唯一的记录编号写入元素;事件发生后先找到对应元素,再读取编号并回到数组、Map 或其他数据源。DOM 只承担索引作用,真实状态仍由 JavaScript 数据维护。

data 属性关联数据项的数据流

完整示例:点击按钮切换任务状态

下面的文件可以直接在浏览器中打开。渲染函数把任务编号写入 li.dataset.id,列表只绑定一个点击监听器;处理事件时先确认目标按钮属于当前列表,再把字符串编号转换为数字并查找记录。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>data 属性关联数据项</title>
</head>
<body>
  <ul id="task-list"></ul>

  <script>
    // 数据是唯一状态源,DOM 只保存用于关联的 ID。
    const tasks = [
      { id: 101, title: "阅读 DOM 文档", done: false },
      { id: 102, title: "完成事件练习", done: true }
    ];

    const list = document.querySelector("#task-list");

    function renderTasks() {
      // 先在片段中组装节点,再一次性替换列表内容。
      const fragment = document.createDocumentFragment();

      for (const task of tasks) {
        const item = document.createElement("li");
        item.dataset.id = String(task.id);

        const text = document.createElement("span");
        text.textContent = `${task.title}:${task.done ? "已完成" : "待完成"}`;

        const button = document.createElement("button");
        button.type = "button";
        button.dataset.action = "toggle";
        button.textContent = "切换状态";

        item.append(text, button);
        fragment.append(item);
      }

      list.replaceChildren(fragment);
    }

    list.addEventListener("click", (event) => {
      if (!(event.target instanceof Element)) return;

      // 先确认动作按钮属于当前列表,避免误处理外部同类节点。
      const button = event.target.closest('button[data-action="toggle"]');
      if (!button || !list.contains(button)) return;

      const item = button.closest("li[data-id]");
      const id = Number(item?.dataset.id);
      const task = tasks.find((current) => current.id === id);
      if (!task) return;

      // 更新数据后统一重绘,避免同时维护两份状态。
      task.done = !task.done;
      renderTasks();
      console.log(`更新 ${task.id}: ${task.done}`);
    });

    renderTasks();
  </script>
</body>
</html>

预期结果

text
页面显示两条任务及“切换状态”按钮。
点击编号 102 对应按钮后,该行变为“完成事件练习:待完成”。
控制台输出:更新 102: false

关键边界

dataset 读取到的值始终是字符串,因此编号为数字时要显式转换。若编号本身可能包含前导零或字母,就不要使用 Number(),而应统一按字符串比较。事件委托还应配合 contains(),避免把容器外部的相似按钮误判为当前列表操作。

记录标识应满足三个条件:在当前集合中唯一、记录生命周期内稳定、长度足够短。标题、数组下标和完整 JSON 都不适合作为关联键;标题可能重复,数组下标会随排序变化,完整对象会造成重复状态和转义风险。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 data 属性关联数据项

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

登录哪都通