Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

data-*: vlastní atributy aplikace

Ukládejte textový stav bez předpokladu důvěryhodnosti či utajení.

Verze: HTML Living Standard

Syntaxe

<button data-item-count="2">Add</button>

Vlastní atributy data-* uchovávají informace pro aplikaci stránky. Za předponu přidejte název, ideálně malými písmeny s pomlčkami. Rozhraní dataset převede například data-item-count na camelCase vlastnost itemCount. Čtení vrací text i tehdy, když atribut obsahuje číslice.

Před výpočty či obchodními rozhodnutími hodnoty převeďte a ověřte. Nastavení dataset vlastnosti aktualizuje příslušný atribut a hodnoty se stávají řetězci. Uživatel je vidí a může měnit: nepatří sem tajemství ani serverová oprávnění. Pokud význam již vyjadřuje standardní atribut, použijte jej.

Tlačítko začíná počítadlem dva. Obsluha výslovně převede text na číslo, zvýší ho a zapíše. Výsledek kontroluje dataset i synchronizovaný atribut a vyhne se náhodnému spojování řetězců.

Pří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ýsledek

beforeType=string; after=3; attribute=3

Převod je výslovný; samotný atribut nedává hodnotě číselný typ.

Zdroje