Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : méthode getAttributeNode()

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode getAttributeNode() de l'interface Element retourne l'attribut défini de l'élément demandé sous la forme d'un nœud Attr. Elle retourne null si l'élément n'a pas d'attribut avec le nom donné.

Cette méthode est utile si vous avez besoin des propriétés d'instance de l'attribut. Si vous avez seulement besoin de la valeur de l'attribut, vous pouvez utiliser la méthode getAttribute() à la place.

Syntaxe

js
getAttributeNode(attrName)

Paramètres

attrName

Une chaîne de caractères définissant le nom de l'attribut. Lorsqu'elle est appelée sur un élément HTML dans un DOM identifié comme un document HTML, le nom est normalisé en minuscules.

Valeur de retour

Un nœud Attr pour l'attribut demandé, ou null si l'élément n'a pas d'attribut avec le nom donné.

Note : Les nœuds Attr héritent de Node, mais ne sont pas considérés comme faisant partie de l'arbre du document. Les attributs habituels des nœuds comme parentNode, previousSibling et nextSibling sont null pour un nœud Attr. Vous pouvez cependant accéder à l'élément auquel cet attribut appartient grâce à la propriété ownerElement.

Exemples

js
// html: <div id="top" />
const t = document.getElementById("top");
const idAttr = t.getAttributeNode("id");
console.log(idAttr.value); // "top"

Spécifications

Spécification
DOM
# dom-element-getattributenode

Compatibilité des navigateurs

Voir aussi