element.tagName
Baseline
Widely available
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.
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,
tagNameappelé 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étagNameest"SomeTag". - Pour les objets
Element, la valeur de l'étiquette de nom est la même que la valeur de la propriéténodeNamehéritée deNode.
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
| Specification |
|---|
| DOM # ref-for-dom-element-tagname① |
Compatibilité des navigateurs
Chargement…