База знанияИзпитен център
BGБългарски
Избери език13

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

Преобразуването е изрично; самият атрибут не прави стойността си числова.

Източници