Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLElement.dataset — dostop do atributov data-*

HTMLElement.dataset izpostavi atribute data-* elementa kot DOMStringMap. Omogoča branje, zapisovanje in brisanje besedilnih podatkov; imena, kot je data-user-id, preslika v userId.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

element.dataset.key
 element.dataset.key = value;
 element.dataset[key] = value;
 delete element.dataset.key;

HTMLElement.dataset vrne z elementom povezan DOMStringMap, ne pa neodvisne kopije podatkov. Spremembe lastnosti posodobijo atribute data-* in obratno. Lastnost dataset je sama samo za branje; spreminjate njene lastnosti.

Pri preslikavi imen se odstrani predpona data-; vezaj pred malo črko ASCII se odstrani, ta črka pa postane velika: data-user-id → userId. Drugi znaki ostanejo nespremenjeni. Pri zapisovanju se velike črke ASCII pretvorijo v vezaj, ki mu sledi mala črka. Zapis ključa z vezajem pred malo črko ASCII, na primer dataset['user-id'], sproži SyntaxError.

Vrednosti so nizi: števila pretvorite izrecno. Z dodelitvijo null se shrani besedilo "null", namesto da bi se atribut odstranil. Za odstranitev uporabite delete element.dataset.userId. Če ključa userId ni, je rezultat undefined.

To je vmesnik standarda HTML Living Standard, ne funkcija določene izdaje ECMAScript. Podpirajo ga trenutni brskalniški pogoni; prisotnost Node 24 v repozitoriju ne dokazuje, da je na voljo DOM.

Primeri

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'));

Rezultat

42
43
string
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri