element.setAttributeNode

Résumé

setAttributeNode ajoute un nouveau nœud Attr à l'élément courant.

Syntaxe

replacedAttr = element.setAttributeNode(attribute)

• attribute est le nœud Attr à définir sur l'élément.
• replacedAttr est le nœud d'attribut remplacé, renvoyé par la fonction, si il y en avait un.

Exemple

// <div id="one" align="left">one</div> 
// <div id="two">two</div> 
var d1 = document.getElementById("one"); 
var d2 = document.getElementById("two"); 
var a = d1.getAttributeNode("align"); 
d2.setAttributeNode(a); 
alert(d2.attributes[1].value) 
// retourne: `left'

Notes

Si l'attribut désigné existe déjà sur l'élément, cet attribut est remplacé par le nouveau et le nœud remplacé est renvoyé.

Cette méthode est peu utilisée. On lui préfère souvent setAttribute pour modifier la valeur d'un attribut d'élément.

Méthodes DOM traitant des attributs sur les éléments :

Les méthodes DOM Level 1 ne prennent pas en compte les espaces de noms tandis que les méthodes DOM Level 2 le font. Les méthodes traitant directement les nœuds Attr sont très rarement utilisées.

Spécification

• DOM Level 2 Core : setAttributeNode — traduction en français (non normative
• Introduit dans DOM Level 1 Core