WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.setAttribute — ein Attribut setzen

Element.setAttribute nimmt den Namen und den Wert eines Attributs eines DOM-Elements entgegen. Bei Erfolg fügt die Methode das Attribut hinzu oder ersetzt seinen Wert.

Version: 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)

Bei einem erfolgreichen Aufruf legt element.setAttribute(qualifiedName, value) ein fehlendes Attribut an oder aktualisiert das erste Attribut mit diesem Namen. Dies ist eine DOM-Methode und keine Funktion von ECMAScript selbst.

Wenn die Content Security Policy (CSP) Trusted Types erzwingt, kann eine einfache Zeichenkette als Wert für ein geschütztes Attribut wie onclick einen TypeError auslösen, ohne dass das Attribut angelegt oder aktualisiert wird.

Bei Elementen im HTML-Namespace, die zu einem HTML-Dokument gehören, wird der Name in ASCII-Kleinbuchstaben umgewandelt. Ein ungültiger Name löst eine DOMException vom Typ InvalidCharacterError aus. Verwende setAttributeNS, um Attribute mit einem bestimmten Namespace zu setzen.

Beispiele

const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));

Ergebnis

ready

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert. Das Beispiel mit `data-state` zeigt nicht, wie sich das Erzwingen von Trusted Types auf ein geschütztes Attribut auswirkt.

Quellen