CKTIS / JavaScript
HTMLElement.dataset — pristup atributima data-*
HTMLElement.dataset izlaže atribute data-* elementa kao DOMStringMap. Omogućuje čitanje, zapisivanje i brisanje tekstualnih podataka; nazive poput data-user-id preslikava u userId.
Verzija: 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 vraća DOMStringMap povezan s elementom, a ne neovisnu kopiju podataka. Promjene svojstava ažuriraju atribute data-* i obratno. Samo svojstvo dataset je samo za čitanje; mijenjaju se njegova svojstva.
Preslikavanje naziva uklanja prefiks data-; crtica ispred malog ASCII slova uklanja se, a to slovo postaje veliko: data-user-id → userId. Ostali znakovi ostaju nepromijenjeni. Pri zapisivanju velika ASCII slova postaju crtica iza koje slijedi malo slovo. Zapis ključa koji sadrži crticu ispred malog ASCII slova, primjerice dataset['user-id'], izaziva SyntaxError.
Vrijednosti su nizovi znakova: brojeve izričito pretvorite. Dodjela null pohranjuje tekst "null", umjesto da ukloni atribut. Za njegovo uklanjanje upotrijebite delete element.dataset.userId. Ako ključ userId nedostaje, rezultat je undefined.
Ovo je sučelje standarda HTML Living Standard, a ne značajka određenog izdanja ECMAScripta. Podržavaju ga aktualni preglednički pogoni; prisutnost Node 24 u repozitoriju ne dokazuje dostupnost DOM-a.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.