CKTIS / HTML
data-*: lastni atributi aplikacije
Shranite besedilno stanje, ne da bi ga šteli za zaupanja vredno ali tajno.
Različica: HTML Living Standard
Sintaksa
<button data-item-count="2">Add</button>Lastni atributi data-* hranijo informacije za aplikacijo strani. Za predpono dodajte ime, najbolje z malimi črkami in vezaji. Vmesnik dataset denimo preslika data-item-count v lastnost itemCount v zapisu camelCase. Branje vrne besedilo, tudi če atribut vsebuje števke.
Vrednosti pretvorite in preverite pred računanjem ali poslovnimi odločitvami. Nastavitev lastnosti dataset posodobi ustrezni atribut; dodeljene vrednosti postanejo nizi. Uporabnik jih vidi in lahko spremeni: niso za skrivnosti ali strežniška pooblastila. Uporabite obstoječi standardni atribut, kadar že izraža pomen.
Gumb začne s števcem dve. Obravnava izrecno pretvori niz v število, ga poveča in zapiše nazaj. Rezultat preveri dataset in usklajeni atribut ter se izogne naključnemu združevanju nizov.
Primeri
<!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>Rezultat
beforeType=string; after=3; attribute=3
Pretvorba je izrecna; atribut sam vrednosti ne naredi številske.