data属性是html5中用于存储自定义数据的特性，通过data-前缀定义，如data-id=”123″，可用javaScript的dataset访问，命名转为驼峰格式，如inStock对应data-in-stock，常用于传递配置、绑定ID、标记状态和动态渲染，支持读取与修改，提升HTML与js协作效率。

html元素的data-属性是一种在dom元素上存储自定义数据的有效方式，这些数据可以直接被javascript读取和操作，用于驱动页面逻辑。它既保持了HTML的语义化，又避免了使用全局变量或额外的数据结构。

什么是data属性

data属性是html5引入的标准，允许你在任意HTML元素上添加以data-开头的自定义属性。例如：

<div id=”product” data-id=”123″ data-name=”iphone” data-in-stock=”true”></div>

这些值不会显示在页面上，但可以通过JavaScript轻松访问。

通过dataset访问data属性

JavaScript提供了dataset属性来读取和设置元素上的所有data-字段。命名规则是：去掉data-前缀，后续单词首字母大写（驼峰命名）。

立即学习“前端免费学习笔记（深入）”；

示例：

const element = document.getElementById(‘product’);
console.log(element.dataset.id); // “123”
console.log(element.dataset.name); // “iPhone”
console.log(element.dataset.inStock); // “true”

注意：data-in-stock变成inStock。

腾讯混元

腾讯混元大由腾讯研发的大语言模型，具备强大的中文创作能力、逻辑推理能力，以及可靠的任务执行能力。

65

查看详情

在JS逻辑中使用data属性的常见场景

data属性适合用于以下情况：

• 传递配置参数：比如一个按钮控制轮播图方向，用data-direction="next"告诉JS行为意图。
• 绑定数据ID：列表项中存储后端返回的记录ID，便于删除或编辑时使用。
• 状态标记：如data-active="true"标识当前激活项，JS据此执行不同逻辑。
• 动态内容渲染：模版元素携带原始数据，JS读取后生成DOM。

例子：点击删除按钮移除商品

<button class=”delete-btn” data-product-id=”456″>删除</button> document.querySelectorAll(‘.delete-btn’).foreach(btn => {
  btn.addEventListener(‘click’, function() {
    const productId = this.dataset.productId;
    // 发送请求或更新本地状态
    removeProduct(productId);
  });
});

修改和更新data属性

你也可以通过dataset动态修改data值：

element.dataset.inStock = “false”;
// 对应的DOM变为 data-in-stock=”false”

这在状态变化时很有用，比如用户加入购物车后更新data-added="true"。

基本上就这些。合理使用data属性能让HTML与JS协作更清晰，减少冗余代码，提升可维护性。不复杂但容易忽略细节，比如命名转换和类型始终为字符串，必要时需手动转换。