element.tagName

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

BCD tables only load in the browser