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.