HTML - data-*
The data-* global attributes form a class of attributes, called custom data attributes, allows proprietary information to be exchanged between the HTML and its DOM representation that may be used by scripts. All such custom data are available via the HTMLElement interface of the element the attribute is set on. The HTMLElement.dataset property gives access to them.
The * may be replaced by any name following the production rule of xml names with the following restrictions:
Description
The data-* global attributes form a class of attributes, called custom data attributes, allows proprietary information to be exchanged between the HTML and its DOM representation that may be used by scripts. All such custom data are available via the HTMLElement interface of the element the attribute is set on. The HTMLElement.dataset property gives access to them.
The * may be replaced by any name following the production rule of xml names with the following restrictions:
- the name must not start with
xml, whatever case is used for these letters; - the name must not contain any semicolon (
U+003A); - the name must not contain capital
AtoZletters.
Note that the HTMLElement.dataset property is a DOMStringMap and the name of the custom data attribute data-test-value will be accessible via HTMLElement.dataset.testValue as any dash (U+002D) is replaced by the capitalization of the next letter (camelcase).
Browser Compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | (Yes) | 6 (6) | (Yes) | (Yes) | (Yes) |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | 6.0 (6) | (Yes) | (Yes) | (Yes) | (Yes) |
See Also
- All global attributes.
- The
HTMLElement.datasetproperty that allows to access and modify these values.
Specifications
| Specification | Status | Comment |
|---|---|---|
| WHATWG HTML Living Standard The definition of 'data-*' in that specification. |
Living Standard | No change from latest snapshot, HTML5.1 |
| HTML5.1 The definition of 'data-*' in that specification. |
Working Draft | Snapshot of WHATWG HTML Living Standard, no change from HTML5 |
| HTML5 The definition of 'data-*' in that specification. |
Recommendation | Snapshot of WHATWG HTML Living Standard, initial definition. |
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/html/global_attributes/data-*