0

0

HTML5的Dataset属性怎么用?如何存取自定义数据?

月夜之吻

月夜之吻

发布时间:2025-07-10 22:32:02

|

230人浏览过

|

来源于php中文网

原创

html5的dataset属性是一种在html元素上存储和访问自定义数据的规范化方式。它通过以data-开头的属性实现,例如data-user-id="12345",随后可以通过javascript的dataset对象读取,如element.dataset.userid;1. 存储数据:在html标签中添加data-属性;2. 读取数据:使用dataset对象并通过驼峰命名访问;3. 修改数据:直接赋值dataset属性;4. 删除数据:用delete操作符或removeattribute方法。相比传统非标准属性,data-是语义化、规范化的,且提供更简洁的操作接口。常见应用场景包括ui状态管理、事件委托、小型配置存储和拖放操作的数据传递。性能方面,频繁读写影响不大,但不适合存储大量数据;安全方面,不应存储敏感信息,并防范xss攻击。

HTML5的Dataset属性怎么用?如何存取自定义数据?

HTML5的dataset属性,说白了,就是让你能在HTML元素上存取自定义数据的一种规范化方式。它解决了以前我们为了在DOM上挂载数据,不得不乱用idclass,或者直接添加非标准属性的尴尬。现在,只要以data-开头,后面跟上你的键名,就能把数据直接写在标签上,然后通过JavaScript方便地读取和操作,这让HTML元素不再只是一个展示的容器,它也能携带一些“私房话”给JS用,而且是合法的、语义化的。

HTML5的Dataset属性怎么用?如何存取自定义数据?

解决方案

要使用HTML5的dataset属性来存取自定义数据,过程其实非常直观。

存储数据: 你需要在HTML元素的标签中,添加以data-为前缀的属性。例如:

HTML5的Dataset属性怎么用?如何存取自定义数据?
这是一个用户资料卡片。

这里,data-user-iddata-user-namedata-is-active就是我们自定义的数据属性。

立即学习前端免费学习笔记(深入)”;

读取数据: 在JavaScript中,你可以通过元素的dataset属性来访问这些数据。dataset属性会返回一个DOMStringMap对象,其中包含了所有data-属性。需要注意的是,如果你的data-属性名中包含连字符(-),在JavaScript中访问时需要转换为驼峰命名法。

HTML5的Dataset属性怎么用?如何存取自定义数据?
const userProfileDiv = document.getElementById('userProfile');

// 读取数据
const userId = userProfileDiv.dataset.userId; // '12345'
const userName = userProfileDiv.dataset.userName; // '张三'
const isActive = userProfileDiv.dataset.isActive; // 'true' (注意,这里读取到的是字符串)

console.log(`用户ID: ${userId}`);
console.log(`用户名: ${userName}`);
console.log(`是否活跃: ${isActive}`);

可以看到,data-user-id变成了dataset.userIddata-is-active变成了dataset.isActive

修改数据: 修改数据就像修改普通的JavaScript对象属性一样简单:

userProfileDiv.dataset.isActive = 'false';
console.log(`更新后是否活跃: ${userProfileDiv.dataset.isActive}`); // 'false'

删除数据: 删除一个data-属性也有两种方式:

// 方式一:使用delete操作符
delete userProfileDiv.dataset.userName;
console.log(`删除用户名后: ${userProfileDiv.dataset.userName}`); // undefined

// 方式二:使用removeAttribute方法(更推荐,因为它直接操作DOM属性)
userProfileDiv.removeAttribute('data-user-id');
console.log(`删除用户ID后: ${userProfileDiv.dataset.userId}`); // undefined

通常我更倾向于removeAttribute,因为它更明确地表达了“从DOM上移除这个属性”的意图。

HTML5 data-* 属性与传统自定义属性有何不同?

当我们谈论在HTML元素上存储数据时,过去确实有一些“野路子”或者说不那么规范的做法。最常见的,就是直接在标签上添加一个非标准的属性,比如

。这种做法虽然在某些浏览器中也能工作,但它不符合HTML规范,可能会导致HTML验证失败,而且更重要的是,它缺乏语义。浏览器并不知道这个my-custom-data属性是干嘛用的,它只是一个未知属性。

而HTML5的data-*属性,它的核心区别就在于“规范化”和“语义化”。 data-*是HTML5标准明确规定的,专门用于存储自定义数据的属性。这意味着你的HTML代码是有效的、合规的。 从JavaScript访问的角度来看,传统自定义属性你只能通过element.getAttribute('my-custom-data')element.setAttribute('my-custom-data', 'new-value')来操作。而data-*属性则提供了一个更便捷、更面向对象的接口:element.dataset。这个dataset对象是一个DOMStringMap,它会自动处理连字符到驼峰命名的转换,让你的JS代码看起来更简洁、更具可读性。

在我看来,data-*不仅仅是解决了HTML验证的问题,它更是一种意图的表达。当你在一个元素上看到data-something时,你立刻就知道:“哦,这个是给JavaScript用的,是这个元素特有的数据。”这比看到一个随意命名的非标准属性要清晰得多,也更有助于团队协作和代码维护。这就像是给你的HTML元素贴上了一张小标签,上面写着“这是给JS看的备忘录”。

dataset 属性在前端开发中有哪些常见的应用场景?

dataset属性在现代前端开发中简直是无处不在,它的便利性让很多过去需要复杂逻辑才能实现的功能变得简单。

一个很典型的场景就是UI状态管理。想象一个列表,每个列表项可能需要知道自己是否被选中、是否处于编辑模式,或者它对应的数据库ID是什么。你完全可以将这些状态直接存储在列表项的data-*属性中:

  • 商品A
  • 商品B
  • 当用户点击时,JavaScript可以直接读取event.target.dataset.selected来判断并更新状态,而不需要去遍历DOM或者维护一个复杂的JS对象来映射。

    另一个非常强大的应用是事件委托。如果你有一个包含成百上千个列表项的巨大列表,给每个列表项都绑定点击事件会消耗大量内存和性能。更好的做法是在它们的父元素上绑定一个事件监听器,然后通过event.target.dataset来判断是哪个子元素被点击了,并获取其相关数据。比如,一个商品列表的“加入购物车”按钮,你可以把商品ID存在按钮的data-product-id上,父元素监听点击事件后,就能轻松知道是哪个商品要被加入了。

    citySHOP 多用户商城
    citySHOP 多用户商城

    citySHOP是一款集CMS、网店、商品、系统,管理更加科学快速;全新Jquery前端引擎;智能缓存、图表化的数据分析,手机短信营销;各种礼包设置、搭配购买、关联等进一步加强用户体验;任何功能及设置都高度自定义;MVC架构模式,代码严禁、规范;商品推荐、促销、礼包、折扣、换购等多种设置模式;商品五级分类,可自由设置分类属性;商品展示页简介大方,清晰,图片自动放大,无需重开页面;商品评价、咨询分开

    下载

    JS代码:

    document.getElementById('productList').addEventListener('click', function(event) {
        const target = event.target;
        if (target.dataset.action === 'add-to-cart') {
            console.log(`加入购物车:${target.dataset.productId}`);
        } else if (target.dataset.action === 'view-details') {
            console.log(`查看详情:${target.dataset.productId}`);
        }
    });

    这种模式让代码变得非常简洁高效。

    此外,它也常用于小型配置信息的存储,比如一个组件可能需要一些初始化参数,但这些参数又不适合放在全局变量里,或者需要与特定的DOM实例关联。还有拖放操作中,拖动源元素可以把它的ID或类型存在data-属性里,拖放目标在接收时就能快速识别。可以说,dataset让HTML元素从一个纯粹的“展示者”变成了能够“携带信息”的载体,极大地提升了前端开发的灵活性和数据与UI的耦合度(是好的耦合)。

    使用 dataset 属性时需要注意哪些性能或安全问题?

    尽管dataset属性非常方便,但在实际使用中,我们还是需要留意一些潜在的性能和安全考量。

    首先是性能方面。有人可能会担心,频繁地读写dataset属性会不会影响性能?理论上,直接操作DOM属性(包括dataset)确实会比操作纯JavaScript对象要慢一些,因为涉及到浏览器内部的DOM更新机制。然而,在绝大多数现代Web应用场景下,这种性能差异微乎其微,几乎可以忽略不计。除非你在一个高频循环中对成千上万个元素进行dataset的读写操作,否则通常不会成为性能瓶颈。真正的性能杀手往往是DOM的重绘回流(reflow/repaint),而单纯修改data-*属性本身并不会直接触发这些操作,除非你修改的属性间接影响了元素的布局或样式。

    一个更实际的性能考量是数据量dataset毕竟是将数据存储在DOM元素上,这意味着这些数据会成为DOM树的一部分,占用内存。如果你试图在data-*属性中存储大量的数据,比如一个复杂的JSON对象字符串,这可能会导致DOM树变得臃肿,增加内存消耗,并且在序列化/反序列化时也会带来额外的开销。对于大量或复杂的数据,更推荐的做法是将其存储在JavaScript变量、Web Storage(localStorage/sessionStorage)或者专门的状态管理库中,然后在data-*属性中只存储一个ID或者一个引用,用作JS和DOM之间的桥梁。

    其次是安全方面。这是我个人觉得更需要警惕的地方。data-*属性的内容是直接暴露在客户端的,任何用户都可以通过浏览器的开发者工具轻易查看。因此,*绝对不要在`data-`属性中存储任何敏感信息**,比如用户的密码、API密钥、会话令牌等。这些数据应该始终在服务器端处理,或者通过安全的HTTP Only Cookie等方式传输。

    另一个安全隐患是XSS(跨站脚本攻击)风险。如果你的data-*属性值是直接来自用户输入,并且你在JavaScript中又将这个值不加过滤地插入到HTML中(例如使用innerHTML),那么恶意用户就可以注入脚本。例如:

    JS:

    const userInputDiv = document.querySelector('[data-user-input]');
    document.body.innerHTML += userInputDiv.dataset.userInput; // 危险!

    为了避免这种风险,永远要对来自用户或不可信源的数据进行严格的净化(sanitization)处理,无论这些数据是存储在dataset中还是其他地方,尤其是在将其渲染到DOM之前。

    总的来说,dataset是一个非常实用的工具,它极大地简化了DOM和JavaScript之间的数据交互。只要我们遵循最佳实践,避免存储过大数据和敏感信息,并对用户输入保持警惕,它的价值远大于可能带来的微小风险。

    相关专题

    更多
    js获取数组长度的方法
    js获取数组长度的方法

    在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

    551

    2023.06.20

    js刷新当前页面
    js刷新当前页面

    js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

    374

    2023.07.04

    js四舍五入
    js四舍五入

    js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

    730

    2023.07.04

    js删除节点的方法
    js删除节点的方法

    js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

    475

    2023.09.01

    JavaScript转义字符
    JavaScript转义字符

    JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

    394

    2023.09.04

    js生成随机数的方法
    js生成随机数的方法

    js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

    990

    2023.09.04

    如何启用JavaScript
    如何启用JavaScript

    JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

    656

    2023.09.12

    Js中Symbol类详解
    Js中Symbol类详解

    javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

    551

    2023.09.20

    c++主流开发框架汇总
    c++主流开发框架汇总

    本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

    15

    2026.01.09

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    如何进行WebSocket调试
    如何进行WebSocket调试

    共1课时 | 0.1万人学习

    TypeScript全面解读课程
    TypeScript全面解读课程

    共26课时 | 5万人学习

    关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
    php中文网:公益在线php培训,帮助PHP学习者快速成长!
    关注服务号 技术交流群
    PHP中文网订阅号
    每天精选资源文章推送

    Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号