Element : méthode getElementsByTagNameNS()
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 getElementsByTagNameNS() de l'interface Element retourne une collection HTMLCollection dynamique avec le nom de balise donné appartenant à l'espace de noms donné. Elle est semblable à la méthode Document.getElementsByTagNameNS mais cette dernière recherche sur l'ensemble du document tandis que getElementsByTagNameNS() recherche parmi les descendants de l'élément courant.
Syntaxe
getElementsByTagNameNS(namespaceURI, localName)
Paramètres
namespaceURI-
L'URI de l'espace de noms des éléments à rechercher (cf.
Element.namespaceURIetAttr.namespaceURI). Par exemple, si vous recherchez des éléments XHTML, utilisez l'URI d'espace de noms XHTML,http://www.w3.org/1999/xhtml. localName-
Le nom local des éléments à rechercher ou la valeur spéciale
"*", qui correspond à tous les éléments (cf.Element.localNameetAttr.localName).
Valeur de retour
Une collection HTMLCollection dynamique des éléments trouvés, dans l'ordre d'apparition dans l'arbre du DOM.
Exemples
// Vérifie le statut de chaque cellule de données dans un tableau
const table = document.getElementById("forecast-table");
const cells = table.getElementsByTagNameNS(
"http://www.w3.org/1999/xhtml",
"td",
);
for (const cell of cells) {
const axis = cell.getAttribute("axis");
if (axis === "year") {
// Saisir les données
}
}
Spécifications
| Spécification |
|---|
| DOM # dom-element-getelementsbytagnamens |