Element: getElementsByTagNameNS() Methode

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.

Die Element.getElementsByTagNameNS() Methode gibt ein Live-HTMLCollection von Elementen mit dem angegebenen Tag-Namen zurück, die zu dem angegebenen Namensraum gehören. Sie ist ähnlich wie Document.getElementsByTagNameNS, mit dem Unterschied, dass die Suche auf die Nachkommen des angegebenen Elements beschränkt ist.

Syntax

js
getElementsByTagNameNS(namespaceURI, localName)

Parameter

namespaceURI

Die Namensraum-URI der zu suchenden Elemente (siehe Element.namespaceURI und Attr.namespaceURI). Zum Beispiel, wenn Sie nach XHTML-Elementen suchen müssen, verwenden Sie die XHTML-Namensraum-URI, http://www.w3.org/1999/xhtml.

localName

Entweder der lokale Name der zu suchenden Elemente oder der spezielle Wert "*", der zu allen Elementen passt (siehe Element.localName und Attr.localName).

Rückgabewert

Eine Live-HTMLCollection der gefundenen Elemente in der Reihenfolge, in der sie im Baum erscheinen.

Beispiele

js
// Check the alignment on a number of cells in a table in an XHTML document.
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") {
    // Grab the data
  }
}

Spezifikationen

Specification
DOM Standard
# dom-element-getelementsbytagnamens

Browser-Kompatibilität

BCD tables only load in the browser