data-属性是传递业务语义、解耦逻辑与DOM的关键桥梁，用于表达“承载什么”而非“长什么样”，必须在需稳定标识、批量提取或避免样式/结构耦合时使用。
data- 属性不是装饰用的，它是前端工程中传递上下文、解耦逻辑与 DOM 结构的关键桥梁。不加 data- 硬编码 class 名或 id 去查元素，等于把业务逻辑和样式/结构强绑死，一改就崩。
什么时候必须用 data- 而不是 class 或自定义属性
当你要表达「这个元素承载了什么业务语义」，而不是「它长什么样」或「它属于哪一类样式」时，data- 就不可替代。
-
class="btn-primary"描述外观；data-action="delete"描述行为意图 -
id="user-123"是 DOM 定位标识，但容易冲突；data-user-id="123"是稳定、可批量提取的业务 ID - 直接写
el.dataset.userId = 123比el.setAttribute('userId', 123)安全——后者不会被dataset识别，且违反 HTML 规范 - 服务端渲染（SSR）后，JS 初始化时靠
document.querySelectorAll('[data-component="chart"]')找挂载点，比靠 class 更精准、不易误触第三方组件
dataset 的大小写转换规则和坑
data- 属性名在 JS 中通过 dataset 访问时会自动驼峰化，但规则有边界：
-
data-user-id→el.dataset.userId（正确） -
data-user_id→el.dataset.user_id（保留下划线，不转驼峰） -
data-userID→el.dataset.userid（全小写，大写字母被吞） -
data-123-id→el.dataset[123Id]无效，数字开头的 key 无法通过点号访问，只能用el.dataset['123-id']
最稳妥做法：只用小写字母 + 连字符，命名保持语义清晰，如 data-table-row-index、data-modal-trigger。
立即学习“前端免费学习笔记（深入）”；
真实项目中三个高频用法
不是所有 data- 都值得加。下面三种场景，加了能省掉大量条件判断和查找逻辑：
- 表格行操作：在
<tr data-order-id="789">上绑定点击事件，回调里直接取e.target.closest('tr').dataset.orderId，不用再向上找 parentElement、再 parse id - 懒加载占位图：图片标签写
<img src="/placeholder.jpg">，滚动监听触发后img.src = img.dataset.src，避免初始请求爆炸 - 表单字段校验上下文：输入框写
<input data-required="true" data-min-length="6" data-pattern="email">，统一校验函数读取这些值动态生成规则，而不是写一堆 if-else 分支
别让 data- 变成状态垃圾桶
它只适合存**初始化时确定、后续不变或仅由 JS 主动更新**的轻量元信息。以下情况请立刻停手：
- 存复杂对象 JSON 字符串（如
data-config='{"theme":"dark","lang":"zh"}'）→ 改用<script type="application/json" id="app-config">更清晰 - 频繁读写（比如每帧更新
data-progress）→ 性能差，DOM 属性操作比普通变量慢一个数量级，该用requestAnimationFrame+ 内存变量 - 存用户敏感数据（如
data-token）→ 可被任意脚本读取，等同于明文暴露，token 应始终走 HTTP-only cookie 或内存变量
真正难的不是怎么加 data-，而是每次写之前问一句：这个信息，是 DOM 必须知道的，还是我其实可以把它藏在组件实例或 store 里？
