Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje