Element : propriété tagName
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 propriété en lecture seule tagName de l'interface Element retourne le nom de la balise de l'élément sur lequel elle est appelée.
Par exemple, si l'élément est une image (<img>), sa propriété tagName est IMG (pour les documents HTML ; elle peut être différente pour les documents XML/XHTML). Note : vous pouvez utiliser la propriété localName pour accéder au nom local de l'élément — qui dans le cas de l'exemple est img (en minuscules).
Valeur
Une chaîne de caractères indiquant le nom de la balise de l'élément. La capitalisation de cette chaîne de caractères dépend du type de document :
- Pour les arbres DOM représentant des documents HTML, le nom de la balise retourné est toujours sous sa forme canonique en majuscules. Par exemple,
tagNameappelé sur un élément HTML<div>retourne"DIV". - Les noms de balises 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 balise
"<UneBalise>", alors la valeur de la propriététagNameest"UneBalise".
Pour les objets Element, la valeur de tagName est la même que celle de la propriété nodeName que l'objet élément hérite de Node.
Exemples
HTML
<span id="naissance">Lorsque je suis né…</span>
JavaScript
const span = document.getElementById("naissance");
console.log(span.tagName);
En XHTML (ou tout autre format XML), la casse d'origine est conservée, de sorte que "span" est affiché dans le cas où le nom de la balise d'origine a été créé en minuscules. En HTML, "SPAN" est affiché à la place quelle que soit la casse utilisée lors de la création du document original.
Spécifications
| Spécification |
|---|
| DOM # ref-for-dom-element-tagname① |
Compatibilité des navigateurs
Voir aussi
- La propriété
Element.localName