Element.getElementsByTagNameNS()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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
# dom-element-getelementsbytagnamens

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getElementsByTagNameNS
getElementsByTagNameNS(namespaceURI, "*")

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.