Dokument: createAttributeNS() Methode

Syntax

createAttributeNS(namespaceURI, qualifiedName)

Parameter

namespaceURI

Ein String, der die namespaceURI angibt, die mit dem Attribut verknüpft werden soll, oder der leere String. In HTML-Dokumenten befinden sich die meisten Attribute im Null-Namespace – verwenden Sie hierfür den leeren String. Verwenden Sie einen spezifischen Namespace-URI nur, wenn Sie ein namespaced Attribut erstellen, wie etwa xml:lang oder xml:space. Einige Namespace-URIs sind:

• XML: http://www.w3.org/XML/1998/namespace (für xml:lang, xml:space)
• XMLNS: http://www.w3.org/2000/xmlns/ (für xmlns, xmlns:*)
• XLink: http://www.w3.org/1999/xlink (für xlink:href, xlink:title, etc.)

qualifiedName

Ein String, der den qualifizierten Namen des neuen Attributs enthält. Die name Eigenschaft des erstellten Attributs wird mit diesem Wert initialisiert.

Das Format des qualifizierten Namens ist prefix:localName oder localName, wobei die Teile wie folgt definiert sind:

prefix Optional

Ein "kurzer Alias" für den Namespace. Das Präfix ist optional, aber wenn es angegeben wird, muss auch der namespaceURI Parameter angegeben werden. Wenn das Präfix auf xml oder xmlns gesetzt ist, muss namespaceURI auf http://www.w3.org/XML/1998/namespace bzw. http://www.w3.org/2000/xmlns/ gesetzt werden.

Der Wert wird verwendet, um die prefix Eigenschaft des neuen Attributs zu initialisieren. Standardmäßig null.

localName

Der lokale Name des Attributs. Der Wert wird verwendet, um die localName Eigenschaft des neuen Attributs zu initialisieren.

Rückgabewert

Der neue Attr Knoten.

Ausnahmen

NamespaceError DOMException

Ausgelöst, wenn der namespaceURI Wert:

• kein gültiger Namespace-URI ist.
• auf den leeren String gesetzt ist, wenn prefix einen Wert hat.
• nicht der Wert http://www.w3.org/XML/1998/namespace oder http://www.w3.org/2000/xmlns/ ist, wenn prefix auf xml oder xmlns gesetzt ist.

InvalidCharacterError DOMException

Ausgelöst, wenn entweder das prefix oder localName nicht gültig ist:

• Das prefix muss mindestens ein Zeichen haben und darf kein ASCII-Leerzeichen, NULL, / oder > (U+0000, U+002F oder U+003E, jeweils) enthalten.
• Das localName muss mindestens ein Zeichen haben und darf kein ASCII-Leerzeichen, NULL, /, = oder > (U+0000, U+002F, U+003D oder U+003E, jeweils) enthalten.

Hinweis: Früherer Versionen der Spezifikation waren restriktiver und erforderten, dass das localName ein gültiger XML-Name ist.

Beispiele

Erstellen eines namespaced Attributs

Dieses Beispiel erstellt ein xml:lang Attribut mit dem XML-Namespace und fügt es einem Absatz-Element hinzu. Dieses Attribut gibt die Sprache des Inhalts des Elements für die XML-Verarbeitung an.

<p id="greeting">Bonjour!</p>

const el = document.getElementById("greeting");
const attr = document.createAttributeNS(
  "http://www.w3.org/XML/1998/namespace",
  "xml:lang",
);
attr.value = "fr";
el.setAttributeNode(attr);

Erstellen eines unpräfixierten Attributs

In HTML-Dokumenten befinden sich unpräfixierte Attribute (wie SVG-Präsentationsattribute wie viewBox) im Null-Namespace. Verwenden Sie den leeren String für den namespaceURI Parameter, um dies zu erreichen.

<svg id="svg"></svg>

const svg = document.getElementById("svg");
const attr = document.createAttributeNS("", "viewBox");
attr.value = "0 0 100 100";
svg.setAttributeNode(attr);
console.log(svg.getAttribute("viewBox")); // "0 0 100 100"

Beachten Sie, dass Sie in den meisten Fällen Element.setAttribute() anstelle von createAttributeNS() für unpräfixierte Attribute verwenden können:

svg.setAttribute("viewBox", "0 0 100 100");

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Document.createAttribute()
• Document.createElementNS()
• Element.setAttributeNS()
• Element.setAttributeNode()
• Element.setAttributeNodeNS()