element.getAttribute

Résumé

getAttribute renvoie la valeur d'un attribut donné de l'élément spécifié. Si l'attribut n'existe pas, la valeur renvoyée sera soit null soit "" (une chaîne vide) ; voir Notes pour plus de détails.

Syntaxe

attribut = element.getAttribute(nom_attribut)

où

• attribut est une chaîne contenant la valeur de l'attribut nom_attribut.
• nom_attribut est le nom de l'attribut dont on désire connaître la valeur.

Exemple

var div1 = document.getElementById("div1");
var align = div1.getAttribute("align");
alert(align); // affiche la valeur de l'attribut align pour l'élément dont l'id="div1"

Notes

À peu près tous les navigateurs (Firefox, Internet Explorer, Opera, Safari, Konqueror et iCab, sans que cette liste soit exhaustive) renvoient null lorsque l'attribut demandé n'existe pas sur l'élément spécifié. La spécification DOM indique cependant que la valeur de retour correcte dans ce cas est en fait la chaîne vide, et certaines implémentation DOM auront ce comportement. Par conséquent, vous devriez utiliser hasAttribute pour vérifier l'existence d'un attribut avant d'appeler getAttribute() s'il est possible que l'attribut n'existe pas sur l'élément spécifié.

Le paramètre nom_attribut est généralement sensible à la casse, mais ne l'est pas lorsqu'il est utilisé sur des éléments HTML.

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 : getAttribute — traduction en français (non normative)
• Cette méthode est apparue dans DOM Level 1 Core