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

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.

Zdroje