element.tagName
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 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,
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 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 Standard # ref-for-dom-element-tagname① |
Compatibilité des navigateurs
BCD tables only load in the browser