Renvoie le nom de l'étiquette de l'élément sur lequel elle est appelée. Si l'élément est une <img>, sa propriété tagName est "IMG" (pour les documents HTML, elle peut être différente pour les documents XML et XHTML).

Syntaxe

elementName = element.tagName;

Valeur

Une chaîne indiquant le nom de l'étiquette de l'élément. Cette chaîne comporte des majuscules selon le type de document :

  • Pour l'arbre DOM qui représente un document HTML, le nom renvoyé est toujours en forme majuscule canonique. Par exemple, tagName appelé sur un élément <div> renvoie "DIV".
  • Les noms des éléments dans un arbre DOM XML, sont retournés dans la même casse que celle utilisée dans le fichier XML d'origine. Si un document XML inclut une étiquette "<SomeTag>", alors la valeur de la propriété tagName est "SomeTag".
  • Pour les objets Element , la valeur de l'étiquette de nom est la même que la valeur de la propriété nodeName héritée de Node.

Exemple

Contenu HTML

<span id="naissance">Lorsque je suis né…</span>

Contenu JavaScript

var span = document.getElementById("naissance");
console.log(span.tagName);

En XHTML (ou tout autre format XML), la casse d'origine sera conservée, de sorte que "span" sera affiché dans le cas où le nom de l'étiquette d'origine a été créé en minuscules. En HTML, "SPAN" serait affiché à la place quelle que soit la casse utilisée lors de la création du document original.

Spécifications

Spécification Statut Commentaire
Document Object Model (DOM) Level 3 Core Specification
La définition de 'Element.tagName' dans cette spécification.
Obsolete Pas de changement
Document Object Model (DOM) Level 2 Core Specification
La définition de 'Element.tagName' dans cette spécification.
Obsolete Définition initiale

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? (Oui) ? ? ? ?

 

Étiquettes et contributeurs liés au document

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