Dom CORE : Objet Element.setAttribute

La méthode javascript setAttribute

Définition

La méthode javascript setAttribute(nom,donnée) de l'objet Element permet de spécifier la valeur d'un attribut d'un élément par rapport à son nom, ou d'en créer un, s'il n'existe pas dans l'élément.
Exemple de code :
<input id="SetAttribute" type="button" value="default" />

var SetAttribute=document.getElementById("SetAttribute");
SetAttribute.setAttribute("value","image");
alert( SetAttribute.getAttribute("value") );
//image

Paramètres de setAttribute

Paramètre

La méthode javascript setAttribute(nom,donnée) de l'objet Element accepte comme paramètres :
- nom : valeur de type string. Elle correspond à nom de l'attribut que l'on veut créer ou assigner une valeur.
- donnée : valeur de type string. Elle correspond à la valeur que l'on veut assigner à l'attribut.

Valeurs retournées de setAttribute

Valeur retournée

La méthode javascript setAttribute(nom,donnée) de l'objet Element retourne une valeur de type String.
Si l'attribut est vide ou n'a pas de valeur par défaut, alors la valeur retournée est une chaîne vide.

Exceptions de setAttribute

Exception

La méthode javascript setAttribute(nom,donnée) de l'objet Element renvoie comme exception :
- INVALID_CHARACTER_ERR: provoquée si le nom spécifié contient un caractère non valide.
- NO_MODIFICATION_ALLOWED_ERR : provoquée si le noeud est en lecture seule.