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 des Document Interfaces erstellt einen neuen Attributknoten mit dem angegebenen Namensraum-URI und qualifizierten Namen.
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.
Syntax
createAttributeNS(namespaceURI, qualifiedName)
Parameter
namespaceURI-
Ein String, der den
namespaceURIangibt, der dem Attribut zugeordnet werden soll, oder der leere String. Einige wichtige Namensraum-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 Namensraum. Das Präfix ist optional, aber wenn es angegeben wird, muss der
namespaceURI-Parameter ebenfalls angegeben werden. Wenn das Präfix aufxmloderxmlnsgesetzt ist, mussnamespaceURIaufhttp://www.w3.org/XML/1998/namespaceoderhttp://www.w3.org/2000/xmlns/gesetzt werden, jeweils entsprechend.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 Namensraum-URI ist.
- auf den leeren String gesetzt ist, wenn
prefixeinen Wert hat. - nicht der Wert
http://www.w3.org/XML/1998/namespaceoderhttp://www.w3.org/2000/xmlns/ist, wennprefixaufxmloderxmlnsgesetzt ist, jeweils entsprechend.
InvalidCharacterErrorDOMException-
Wird ausgelöst, wenn entweder
prefixoderlocalNameungültig ist:- Das
prefixmuss mindestens ein Zeichen haben und darf keine ASCII-Leerzeichen,NULL,/oder>(U+0000, U+002F oder U+003E, jeweils) enthalten. - Das
localNamemuss mindestens ein Zeichen haben und darf keine ASCII-Leerzeichen,NULL,/,=oder>(U+0000, U+002F, U+003D oder U+003E, jeweils) enthalten.
Hinweis: Frühere Versionen der Spezifikation waren restriktiver und verlangten, dass das
localNameein gültiger XML-Name sein musste. - 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 |