HTML data-* 属性


定义和用法

data-* 属性用于存储页面或应用程序私有的自定义数据。

data-* 属性使我们能够在所有 HTML 元素中嵌入自定义数据属性。

然后可以在页面的 JavaScript 中使用存储的(自定义)数据来创建更具吸引力的用户体验(无需任何 Ajax 调用或服务器端数据库查询)。

data-* 属性由两部分组成:

  1. 属性名称不能包含任何大写字母,并且必须在前缀 "data-" 后至少有一个字符
  2. 属性值可以是任意字符串

注释: 以 "data-" 为前缀的自定义属性将被用户代理完全忽略。


适用于

data-* 属性是 全局属性 的一部分,可用于任何 HTML 元素。

元素 属性
所有 HTML 元素 data-*

实例

实例

使用 data-* 属性嵌入自定义数据:

<ul>
  <li data-animal-type="bird">Owl</li>
  <li data-animal-type="fish">Salmon</li>
  <li data-animal-type="spider">Tarantula</li>
</ul>
亲自试一试 »

浏览器支持

表中的数字表示支持该属性的第一个浏览器版本。

属性
data-* 4.0 5.5 2.0 3.1 9.6