通过 element.dataset 对象读写 html5 自定义数据属性,浏览器会自动处理 data- 前缀和连字符转驼峰命名。读取时直接访问属性名,写入时赋值给对应属性即可。

dataset 的键名转换规则是什么
HTML 中的 data-foo-bar 在 JavaScript 中映射为 dataset.fooBar,即去掉 data- 前缀并将后续连字符后的首字母大写。这种转换是自动的,开发者无需手动处理字符串拼接或正则替换。

<div id="item" data-user-id="123" data-is-active="true"></div>
<script>
const el = document.getElementById('item');
console.log(el.dataset.userId); // "123"
console.log(el.dataset.isActive); // "true"
</script>
预期输出:
"123"
"true"
如何动态设置和删除 dataset 属性
设置属性只需对 dataset 对象进行赋值操作,删除属性则使用 delete 关键字。这些操作会同步更新 DOM 元素上的 data-* 属性值,且类型始终为字符串。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

<div id="box"></div>
<script>
const box = document.getElementById('box');
// 设置属性
box.dataset.theme = 'dark';
box.dataset.version = '2.0';
console.log(box.dataset.theme); // "dark"
// 删除属性
delete box.dataset.version;
console.log(box.dataset.version); // undefined
</script>
预期输出:
"dark"
undefined
当 dataset 属性值为数字或布尔值时会发生什么
无论 HTML 中定义的是数字还是布尔值,dataset 读取到的结果始终是字符串类型。这是因为 HTML 属性本质上是文本,JavaScript 不会自动进行类型转换。若需进行数值计算或逻辑判断,必须显式转换类型。
<div id="counter" data-count="42" data-visible="false"></div>
<script>
const counter = document.getElementById('counter');
console.log(typeof counter.dataset.count); // "string"
console.log(counter.dataset.count === '42'); // true
console.log(typeof counter.dataset.visible); // "string"
console.log(counter.dataset.visible === 'false'); // true
console.log(!!counter.dataset.visible); // true (非空字符串为真)
// 正确转换方式
const num = Number(counter.dataset.count);
const bool = counter.dataset.visible === 'true';
console.log(num, typeof num); // 42 "number"
console.log(bool, typeof bool); // false "boolean"
</script>
预期输出:
"string"
true
"string"
true
true
42 "number"
false "boolean"
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










