CKTIS / JavaScript
HTMLElement.dataset — toegang tot data-*-attributen
HTMLElement.dataset stelt de data-*-attributen van een element beschikbaar als een DOMStringMap. Je kunt er tekstgegevens mee lezen, schrijven en verwijderen; data-user-id wordt bijvoorbeeld userId.
Versie: 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 geeft een aan het element gekoppelde DOMStringMap terug, geen onafhankelijke kopie van de gegevens. Wijzigingen aan eigenschappen werken de data-*-attributen bij, en andersom. De eigenschap dataset zelf is alleen-lezen; je wijzigt de eigenschappen ervan.
Bij de naamomzetting wordt het voorvoegsel data- verwijderd. Een koppelteken vóór een kleine ASCII-letter verdwijnt en die letter wordt een hoofdletter: data-user-id → userId. Andere tekens blijven ongewijzigd. Bij het schrijven worden ASCII-hoofdletters omgezet in een koppelteken gevolgd door de kleine letter. Het schrijven van een sleutel met een koppelteken vóór een kleine ASCII-letter, zoals dataset['user-id'], veroorzaakt SyntaxError.
Waarden zijn tekenreeksen: zet getallen expliciet om. Als je null toewijst, wordt de tekst "null" opgeslagen in plaats van het attribuut verwijderd. Gebruik delete element.dataset.userId om het te verwijderen. Een ontbrekende sleutel userId levert undefined op.
Dit is een interface uit de HTML Living Standard, geen functie van een bepaalde ECMAScript-editie. Huidige browser-engines ondersteunen deze interface; de aanwezigheid van Node 24 in een repository bewijst niet dat de DOM beschikbaar is.
Voorbeelden
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'));Resultaat
42 43 string false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.