Element.getElementsByTagNameNS()

La méthode Element.getElementsByTagNameNS() renvoie un objet HTMLCollection 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

js
elements = element.getElementsByTagNameNS(namespaceURI, localName);

Paramètres

namespaceURI

L'URI de l'espace de noms des éléments à rechercher (cf. 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 "*" (correspondant à tous les éléments). Voir Node.localName.

Valeur de retour

Une collection HTMLCollection des éléments trouvés, dans l'ordre d'apparition dans l'arbre du DOM.

Exemples

js
// 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("http://www.w3.org/1999/xhtml", "td");
for (var i = 0; i < cells.length; i++) {
  var axis = cells[i].getAttribute("axis");
  if (axis == "year") {
    // saisit les données
  }
}

Spécifications

Specification
DOM Standard
# dom-element-getelementsbytagnamens

Compatibilité des navigateurs

BCD tables only load in the browser