Document: createAttribute() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Document.createAttribute() Methode erstellt einen neuen Attribut-Knoten und gibt ihn zurück. Das erstellte Objekt ist ein Knoten, der das Attr-Interface implementiert. Das DOM erzwingt nicht, welche Art von Attributen auf diese Weise einem bestimmten Element hinzugefügt werden können.

Hinweis: Der im Parameter angegebene String wird in Kleinbuchstaben umgewandelt.

Syntax

js
createAttribute(name)

Parameter

name

Ein String, der den Namen des Attributs enthält.

Rückgabewert

Ein Attr-Knoten.

Ausnahmen

InvalidCharacterError DOMException

Wird ausgelöst, wenn der name-Wert kein gültiger XML-Name ist; zum Beispiel, wenn er mit einer Zahl, einem Bindestrich oder einem Punkt beginnt oder Zeichen enthält, die keine alphanumerischen Zeichen, Unterstriche, Bindestriche oder Punkte sind.

Beispiele

js
const node = document.getElementById("div1");
const a = document.createAttribute("my_attrib");
a.value = "newVal";
node.setAttributeNode(a);
console.log(node.getAttribute("my_attrib")); // "newVal"

Spezifikationen

Specification
DOM Standard
# dom-document-createattribute

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch