HTML глобальный атрибут data-*

Определение и применение

Глобальный атрибут data-* используется для хранения пользовательских данных (возможность вставить атрибут с пользовательскими данными к любому HTML элементу). Данный атрибут даёт возможность, используя JavaScript предоставить более расширенные возможности для пользователя, не прибегая к запросам на стороне сервера.

Имя атрибута не должно содержать заглавные буквы, а также должно содержать по крайней мере один символ после приставки data-. Значением атрибута может быть любая строка.

Синтаксис:

HTML
<element data-* = "value">

Поддержка браузерами

Спецификация: multipage

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьhtml.global_attributes.data_attributes
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
data-* attributes✓7✓12✓6✓15✓5.1✓18✓6✓14✓5✓1.0✓4.4✓5

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Значения атрибута

Значение
value

data-user-id="42" читается в JavaScript как element.dataset.userId. Значения остаются строками: для расчётов преобразуйте их явно. Атрибуты видны в исходном коде и DOM, поэтому не подходят для хранения секретов.

Примеры, попробуйте сами

Чтение атрибута data-test

Нажмите ▶. Измените разметку во вкладке HTML и сравните результат.

index.html
HTML
<ul>
  <li data-test="звезда" id="event-target-1">Солнце</li>
  <li data-test="спутник" id="event-target-2">Ио</li>
  <li data-test="планета" id="event-target-3">Меркурий</li>
</ul>
main.js
JavaScript
function showDetails(test) {
    var testType = test.getAttribute('data-test')
    alert(test.innerHTML + ' это ' + testType + '.')
}
document.getElementById('event-target-1').addEventListener('click', function () {
    showDetails(this)
})
document.getElementById('event-target-2').addEventListener('click', function () {
    showDetails(this)
})
document.getElementById('event-target-3').addEventListener('click', function () {
    showDetails(this)
})