Résumé
Renvoie une liste d'éléments du nom donné et appartenant à l'espace de noms donné.
Syntaxe
elements =element.getElementsByTagNameNS(namespaceURI,localName)
Paramètres
-
elements
-
Une liste de nœuds (
NodeList
) des éléments trouvés dans leur ordre d'apparition dans l'arbre. -
element
- L'élément depuis lequel la recherche doit débuter. Notez que seuls les descendants de cet élément font partie de la recherche, pas le nœud lui-même.
-
namespaceURI
-
l'URI d'espace de noms des éléments à rechercher (voir
namespaceURI()
). Par exemple, si vous cherchez des éléments XHTML, utilisez l'URI d'espace de noms XHTML,https://www.w3.org/1999/xhtml
. -
localName
-
Soit le nom local des éléments à rechercher, soit la valeur spéciale
"*"
, qui correspond à tous les éléments (voirlocalName()
).
Exemple
// vérifie l'alignement d'une série de cellules d'un tableau dans un document XHTML.
var table = document.getElementById("forecast-table");
var cells = table.getElementsByTagNameNS("https://www.w3.org/1999/xhtml", "td");
for (var i = 0; i < cells.length; i++) {
var axis = cells[i].getAttribute("axis");
if (axis == "year") {
// grab the data
}
}
Notes
element.getElementsByTagNameNS est semblable à document.getElementsByTagNameNS
, sauf que sa recherche est limitée aux descendants de l'élément spécifié.
Spécification
- DOM Level 2 Core: Element.getElementsByTagNameNS (en) — traduction en français (non normative)