Element : méthode getElementsByTagName()
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 méthode getElementsByTagName() de l'interface Element retourne une collection HTMLCollection dynamique d'éléments ayant le nom de balise donné.
Tous les descendants de l'élément défini sont recherchés, mais pas l'élément lui-même. La liste retournée est dynamique, ce qui signifie qu'elle se met à jour automatiquement avec l'arbre DOM. Par conséquent, il n'est pas nécessaire d'appeler Element.getElementsByTagName() avec le même élément et les mêmes arguments de manière répétée si le DOM change entre les appels.
Lorsqu'elle est appelée sur un élément HTML dans un document HTML, getElementsByTagName met en minuscules l'argument avant de le rechercher. C'est indésirable lorsqu'on essaie de faire correspondre des éléments SVG en casse-de-chameau (comme <linearGradient>) dans un document HTML. Utilisez plutôt Element.getElementsByTagNameNS(), qui préserve la capitalisation du nom de la balise.
Element.getElementsByTagName est similaire à Document.getElementsByTagName(), sauf qu'elle ne recherche que les éléments qui sont des descendants de l'élément défini.
Syntaxe
getElementsByTagName(tagName)
Paramètres
tagName-
Le nom qualifié à rechercher. La chaîne de caractères spéciale
"*"représente tous les éléments. Pour la compatibilité avec XHTML, les minuscules doivent être utilisées.
Valeur de retour
Une collection HTMLCollection dynamique d'éléments ayant un nom de balise correspondant, dans l'ordre dans lequel ils apparaissent. Si aucun élément n'est trouvé, la HTMLCollection est vide.
Exemples
// Vérifie le statut de chaque cellule de données dans un tableau
const table = document.getElementById("forecast-table");
const cells = table.getElementsByTagName("td");
for (const cell of cells) {
const status = cell.getAttribute("data-status");
if (status === "open") {
// Saisir les données
}
}
Spécifications
| Spécification |
|---|
| DOM # dom-element-getelementsbytagname |