CKTIS / HTML
data-*: vlastné atribúty aplikácie
Ukladajte textový stav bez predpokladu dôveryhodnosti alebo utajenia.
Verzia: HTML Living Standard
Syntax
<button data-item-count="2">Add</button>Vlastné atribúty data-* uchovávajú informácie pre aplikáciu stránky. Za predponu pridajte názov, ideálne malými písmenami so spojovníkmi. Rozhranie dataset prevedie napríklad data-item-count na camelCase vlastnosť itemCount. Čítanie vracia text aj vtedy, keď atribút obsahuje číslice.
Pred výpočtami alebo obchodnými rozhodnutiami hodnoty preveďte a overte. Nastavenie dataset vlastnosti aktualizuje zodpovedajúci atribút a hodnoty sa stávajú reťazcami. Používateľ ich vidí a môže meniť: nepatria sem tajomstvá ani serverové oprávnenia. Ak význam už vyjadruje štandardný atribút, použite ten.
Tlačidlo začína počítadlom dva. Obsluha výslovne prevedie text na číslo, zvýši ho a zapíše. Výsledok kontroluje dataset aj synchronizovaný atribút a zabraňuje náhodnému spájaniu reťazcov.
Príklady
<!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>Výsledok
beforeType=string; after=3; attribute=3
Prevod je výslovný; samotný atribút nedáva hodnote číselný typ.