CKTIS / JavaScript
Element.setAttribute — een attribuut instellen
Element.setAttribute neemt de naam en waarde van een attribuut van een DOM-element aan. Als de aanroep slaagt, voegt de methode het attribuut toe of vervangt zij de waarde ervan.
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.setAttribute(qualifiedName, value)Als de aanroep slaagt, maakt element.setAttribute(qualifiedName, value) een ontbrekend attribuut aan of werkt het de waarde van het eerste attribuut met die naam bij. Dit is een DOM-methode, geen functie van ECMAScript zelf.
Als het Content Security Policy-beleid (CSP) Trusted Types afdwingt, kan een gewone tekenreeks als waarde voor een beschermd attribuut zoals onclick een TypeError veroorzaken zonder dat het attribuut wordt aangemaakt of bijgewerkt.
Bij elementen in de HTML-naamruimte die bij een HTML-document horen, wordt de naam omgezet naar kleine ASCII-letters. Een ongeldige naam veroorzaakt een DOMException van het type InvalidCharacterError. Gebruik setAttributeNS om attributen met een opgegeven naamruimte in te stellen.
Voorbeelden
const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));Resultaat
ready
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. Het voorbeeld met `data-state` laat niet zien wat het afdwingen van Trusted Types voor een beschermd attribuut betekent.