Dokument: createAttributeNS() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die createAttributeNS() Methode der Document Schnittstelle erstellt einen neuen Attributknoten mit dem angegebenen Namespace-URI und qualifizierten Namen.
Das erstellte Objekt ist ein Knoten, der die Attr Schnittstelle implementiert.
Das DOM erzwingt nicht, welche Art von Attributen auf diese Weise einem bestimmten Element hinzugefügt werden können.
Syntax
createAttributeNS(namespaceURI, qualifiedName)
Parameter
namespaceURI-
Ein String, der den
namespaceURIangibt, der dem Attribut zugeordnet werden soll, oder der leere String. Einige wichtige Namespace-URIs sind: qualifiedName-
Ein String, der den qualifizierten Namen des neuen Attributs enthält. Die
nameEigenschaft des erstellten Attributs wird mit diesem Wert initialisiert.Das Format des qualifizierten Namens ist
prefix:localNameoderlocalName, wobei die Teile wie folgt definiert sind:prefixOptional-
Ein "kurzes Alias" für den Namespace. Das Präfix ist optional, aber wenn es angegeben wird, muss auch der
namespaceURIParameter angegeben werden. Wenn das Präfix aufxmloderxmlnsgesetzt ist, muss dernamespaceURIaufhttp://www.w3.org/XML/1998/namespaceoderhttp://www.w3.org/2000/xmlns/gesetzt werden.Der Wert wird verwendet, um die
prefixEigenschaft des neuen Attributs zu initialisieren. Standardmäßignull. localName-
Der lokale Name des Attributs. Der Wert wird verwendet, um die
localNameEigenschaft des neuen Attributs zu initialisieren.
Rückgabewert
Der neue Attr Knoten.
Ausnahmen
NamespaceErrorDOMException-
Wird ausgelöst, wenn der Wert von
namespaceURI:- kein gültiger Namespace-URI ist.
- auf den leeren String gesetzt ist, wenn
prefixeinen Wert hat. - nicht
http://www.w3.org/XML/1998/namespaceoderhttp://www.w3.org/2000/xmlns/ist, wennprefixentsprechend aufxmloderxmlnsgesetzt ist.
InvalidCharacterErrorDOMException-
Wird ausgelöst, wenn entweder das
prefixoderlocalNamenicht gültig ist:- Das
prefixmuss mindestens ein Zeichen haben und darf keine ASCII-Leerzeichen,NULL,/oder>enthalten (U+0000, U+002F oder U+003E, jeweils). - Das
localNamemuss mindestens ein Zeichen haben und darf keine ASCII-Leerzeichen,NULL,/,=oder>enthalten (U+0000, U+002F, U+003D oder U+003E, jeweils).
Hinweis: Frühere Versionen der Spezifikation waren restriktiver und verlangten, dass das
localNameein gültiger XML-Name ist. - Das
Beispiele
Grundlegende Verwendung
const node = document.getElementById("svg");
const a = document.createAttributeNS("http://www.w3.org/2000/svg", "viewBox");
a.value = "0 0 100 100";
node.setAttributeNode(a);
console.log(node.getAttribute("viewBox")); // "0 0 100 100"
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-document-createattributens |