浏览器与 Web API / 系统课时
使用 data 属性关联数据项
使用 data 属性关联数据项
列表节点被点击时,事件处理器需要知道它代表哪条业务记录。本课使用 data-id 在 DOM 中保存最小标识,再通过 dataset 取回编号并定位原始数据,完成可靠的状态更新。
学习目标
- 理解为什么 DOM 中应保存记录标识,而不是复制完整业务对象。
- 掌握
data-*、dataset、closest()与数组查找的组合用法。 - 能处理字符串类型、无效标识和事件目标越界等边界情况。
从 DOM 标识回到数据源
data-id 的职责是建立“节点与记录”的关联。页面渲染时把稳定且唯一的记录编号写入元素;事件发生后先找到对应元素,再读取编号并回到数组、Map 或其他数据源。DOM 只承担索引作用,真实状态仍由 JavaScript 数据维护。

完整示例:点击按钮切换任务状态
下面的文件可以直接在浏览器中打开。渲染函数把任务编号写入 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 都不适合作为关联键;标题可能重复,数组下标会随排序变化,完整对象会造成重复状态和转义风险。
按自己的节奏,确认真正理解。