CKTIS / HTML
data-*: атрибути за данни на приложението
Съхранявайте текстово състояние в HTML, без да го смятате за тайно или доверено.
Версия: HTML Living Standard
Синтаксис
<button data-item-count="2">Add</button>Собствените атрибути data-* пазят информация за приложението на самата страница. Посочете име след префикса и предпочитайте малки букви с тирета. Интерфейсът dataset преобразува име като data-item-count в свойство itemCount. Четенето връща текст дори когато атрибутът съдържа цифри.
Преобразувайте и проверявайте стойностите преди смятане или бизнес решения. Задаването на свойство в dataset обновява съответния атрибут, а присвоените стойности стават низове. Данните са видими за потребителя и променяеми в браузъра: не са място за тайни или сървърна авторизация. Използвайте съществуващ стандартен атрибут, когато той вече изразява значението.
Бутонът започва с брояч две. Обработчикът изрично превръща низа в число, увеличава го и го записва обратно. Резултатът проверява както стойността в dataset, така и синхронизирания атрибут, като избягва случайно слепване на низове.
Примери
<!doctype html><meta charset="utf-8">
<button id="add" data-item-count="2">Add</button><output id="result"></output><script>
const button = document.querySelector('#add'), beforeType = typeof button.dataset.itemCount;
button.addEventListener('click', () => { button.dataset.itemCount = String(Number(button.dataset.itemCount) + 1); });
button.click();
document.querySelector('#result').textContent = 'beforeType=' + beforeType + '; after=' + button.dataset.itemCount + '; attribute=' + button.getAttribute('data-item-count');
</script>Резултат
beforeType=string; after=3; attribute=3
Преобразуването е изрично; самият атрибут не прави стойността си числова.