CKTIS / JavaScript
HTMLElement.dataset — přístup k atributům data-*
HTMLElement.dataset zpřístupňuje atributy data-* prvku jako DOMStringMap. Umožňuje číst, zapisovat a mazat textová data; názvy jako data-user-id převádí na userId.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.dataset.key
element.dataset.key = value;
element.dataset[key] = value;
delete element.dataset.key;HTMLElement.dataset vrací s prvkem spojenou DOMStringMap, nikoli nezávislou kopii dat. Změny vlastností aktualizují atributy data-* a naopak. Samotná vlastnost dataset je jen pro čtení; měníte její vlastnosti.
Při mapování názvů se odstraní předpona data-; spojovník před malým písmenem ASCII se odstraní a toto písmeno se změní na velké: data-user-id → userId. Ostatní znaky zůstávají beze změny. Při zápisu se velká písmena ASCII převedou na spojovník následovaný malým písmenem. Zápis klíče obsahujícího spojovník před malým písmenem ASCII, například dataset['user-id'], vyvolá SyntaxError.
Hodnoty jsou řetězce: čísla převádějte výslovně. Při přiřazení null se uloží text "null", nikoli odstranění atributu. K jeho odstranění použijte delete element.dataset.userId. Chybějící klíč userId vrací undefined.
Jde o rozhraní standardu HTML Living Standard, nikoli o funkci určité edice ECMAScriptu. Současné prohlížečové enginy je podporují; přítomnost Node 24 v repozitáři nedokazuje dostupnost DOM.
Příklady
const element = document.createElement('div');
element.setAttribute('data-user-id', '42');
console.log(element.dataset.userId);
element.dataset.userId = Number(element.dataset.userId) + 1;
console.log(element.getAttribute('data-user-id'));
console.log(typeof element.dataset.userId);
delete element.dataset.userId;
console.log(element.hasAttribute('data-user-id'));Výsledek
42 43 string false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.