Element: Methode setAttributeNodeNS()

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 setAttributeNodeNS()-Methode des Element-Interfaces fügt einem Element einen neuen nameräumenspezifischen Attr-Knoten hinzu.

Wenn Sie nicht mit dem Attributknoten arbeiten müssen (z. B. durch Klonen von einem anderen Element), bevor Sie ihn hinzufügen, können Sie stattdessen die setAttributeNS()-Methode verwenden.

Wenn Sie mit HTML-Dokumenten arbeiten und das angeforderte Attribut nicht als Teil eines bestimmten Namensraums angeben müssen, verwenden Sie stattdessen die setAttribute()-Methode.

Syntax

js
setAttributeNodeNS(attributeNode)

Parameter

attributeNode

Der Attr-Knoten, der dem Element hinzugefügt werden soll.

Rückgabewert

Der ersetzte Attributknoten, falls vorhanden, der von dieser Funktion zurückgegeben wird.

Beispiele

js
// <div id="one" xmlns:myNS="http://www.mozilla.org/ns/specialspace"
//            myNS:special-align="utterleft">one</div>
// <div id="two">two</div>

const myns = "http://www.mozilla.org/ns/specialspace";
const d1 = document.getElementById("one");
const d2 = document.getElementById("two");
const a = d1.getAttributeNodeNS(myns, "special-align");
d2.setAttributeNodeNS(a.cloneNode(true));
alert(d2.attributes[1].value); // returns: `utterleft'

Hinweise

Wenn das angegebene Attribut bereits auf dem Element existiert, wird dieses Attribut durch das neue ersetzt und das ersetzte wird zurückgegeben.

Beachten Sie, dass Sie, wenn Sie versuchen, ohne das Klonen des Knotens zu setzen, möglicherweise den Fehler NS_ERROR_DOM_INUSE_ATTRIBUTE_ERR "Attribut bereits in Verwendung" sehen, da das DOM das Klonen von Attr erfordert, um wiederverwendet zu werden (im Gegensatz zu anderen Knoten, die verschoben werden können).

Spezifikationen

Specification
DOM Standard
# dom-element-setattributenodens

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch