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)

  • 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 :

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

 

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : fscholz, teoli, jsx, Mgjbot, BenoitL, Fredchat, Domif, Takenbot
Dernière mise à jour par : jsx,