CKTIS / JavaScript
HTMLElement.dataset — prístup k atribútom data-*
HTMLElement.dataset sprístupňuje atribúty data-* prvku ako DOMStringMap. Umožňuje čítať, zapisovať a mazať textové údaje; názvy ako data-user-id mapuje na userId.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.dataset.key
element.dataset.key = value;
element.dataset[key] = value;
delete element.dataset.key;HTMLElement.dataset vracia s prvkom spojenú DOMStringMap, nie nezávislú kópiu údajov. Zmeny vlastností aktualizujú atribúty data-* a naopak. Samotná vlastnosť dataset je iba na čítanie; meníte jej vlastnosti.
Pri mapovaní názvov sa odstráni predpona data-; spojovník pred malým písmenom ASCII sa odstráni a toto písmeno sa zmení na veľké: data-user-id → userId. Ostatné znaky zostávajú nezmenené. Pri zápise sa veľké písmená ASCII zmenia na spojovník nasledovaný malým písmenom. Zápis kľúča obsahujúceho spojovník pred malým písmenom ASCII, napríklad dataset['user-id'], vyvolá SyntaxError.
Hodnoty sú reťazce: čísla konvertujte výslovne. Priradením null sa uloží text "null", nie odstránenie atribútu. Na jeho odstránenie použite delete element.dataset.userId. Chýbajúci kľúč userId vráti undefined.
Ide o rozhranie štandardu HTML Living Standard, nie o funkciu určitého vydania ECMAScriptu. Súčasné prehliadačové enginy ho podporujú; prítomnosť Node 24 v repozitári nedokazuje dostupnosť DOM.
Prí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ýsledok
42 43 string false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.