CKTIS / HTML
data-*: atrybuty własne aplikacji
Przechowuj stan tekstowy w znacznikach, nie uznając go za zaufany ani tajny.
Wersja: HTML Living Standard
Składnia
<button data-item-count="2">Add</button>Własne atrybuty data-* przechowują informacje dla aplikacji strony. Po prefiksie podaj nazwę, najlepiej małymi literami z łącznikami. Interfejs dataset przekształca nazwę taką jak data-item-count we właściwość itemCount zapisaną camelCase. Odczyt zwraca tekst, nawet jeśli atrybut zawiera cyfry.
Przed obliczeniami i decyzjami biznesowymi przekształć oraz sprawdź wartości. Zapis właściwości dataset aktualizuje odpowiedni atrybut, a wartości stają się ciągami znaków. Dane są widoczne dla użytkownika i zmienialne w przeglądarce: nie przechowuj tu tajemnic ani uprawnień serwera. Jeśli znaczenie opisuje standardowy atrybut, użyj jego.
Przycisk zaczyna z licznikiem dwa. Obsługa jawnie zamienia tekst na liczbę, zwiększa ją i zapisuje. Wynik sprawdza zarówno dataset, jak i zsynchronizowany atrybut, unikając przypadkowego sklejania ciągów.
Przykłady
<!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>Wynik
beforeType=string; after=3; attribute=3
Konwersja jest jawna; sam atrybut nie nadaje wartości typu liczbowego.