element.setAttributeNodeNS
setAttributeNodeNS
ajoute un nouveau nœud attribut avec l'espace de noms et le nom spécifiés.
Syntaxe
js
replacedAttr = element.setAttributeNodeNS(attributeNode);
replacedAttr
-
Le nœud attribut remplacé, si applicable, renvoyé par cette fonction.
attributeNode
-
Un nœud
Attr
.
Exemple
js
// <div id="one" special-align="utterleft">one</div>
// <div id="two">two</div>
var myns = "http://www.mozilla.org/ns/specialspace";
var d1 = document.getElementById("one");
var d2 = document.getElementById("two");
var a = d1.getAttributeNodeNS(myns, "special-align");
d2.setAttributeNodeNS(a);
alert(d2.attributes[1].value); // renvoie : "utterleft"
Notes
Si l'attribut spécifié existe déjà sur l'élément, cet attribut est remplacé par le nouveau et l'ancien est renvoyé.
Notez que si vous essayez de définir sans cloner le noeud, Mozilla donne une erreur "Attribut déjà utilisé" NS_ERROR_DOM_INUSE_ATTRIBUTE_ERR, car le DOM nécessite que le clonage d'Attr
soit réutilisé (contrairement aux autres Noeuds qui peuvent être déplacés).
Méthodes DOM traitant des attributs sur les éléments :
DOM Level 1 (le plus courant) | DOM Level 2 | DOM Level 1 traitant directement les nœuds Attr |
DOM Level 2 traitant directement les nœuds Attr |
---|---|---|---|
setAttribute (DOM 1) |
setAttributeNS |
setAttributeNode |
setAttributeNodeNS |
getAttribute (DOM 1) |
getAttributeNS |
getAttributeNode |
getAttributeNodeNS |
hasAttribute (DOM 2) |
hasAttributeNS |
- | - |
removeAttribute (DOM 1) |
removeAttributeNS |
removeAttributeNode |
- |
Spécification
- DOM Level 2 Core: setAttributeNodeNS (en) — traduction en français (non normative)