Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : méthode setAttributeNodeNS()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode setAttributeNodeNS(), rattachée à l'interface Element, ajoute un nouveau nœud Attr d'un espace de noms à l'élément courant.

S'il n'est pas nécessaire de travailler sur le nœud Attr avant de l'ajouter (par exemple en le clonant depuis un autre élément), on pourra utiliser la méthode setAttributeNS() à la place.

Si vous manipulez des documents HTML et n'avez pas besoin d'utiliser d'espace de noms, vous pouvez utiliser la méthode setAttribute() à la place.

Syntaxe

js
setAttributeNodeNS(attributeNode)

Paramètre

attributeNode

Un nœud Attr à associer à l'élément courant (en ajout ou remplacement).

Valeur de retour

L'éventuel nœud Attr remplacé.

Exemples

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));
console.log(d2.attributes[1].value); // returns: `utterleft'

Notes

Si l'attribut indiqué existe déjà sur l'élément, cet attribut est remplacé par le nouveau et l'ancien est renvoyé.

Spécifications

Specification
DOM
# dom-element-setattributenodens

Compatibilité des navigateurs

Voir aussi