Element: getElementsByTagName()-Methode

Die Element.getElementsByTagName()-Methode gibt eine lebendige HTMLCollection von Elementen mit dem angegebenen Tag-Namen zurück.

Alle Nachfahren des spezifizierten Elements werden durchsucht, aber nicht das Element selbst. Die zurückgegebene Liste ist lebendig, was bedeutet, dass sie sich automatisch mit dem DOM-Baum aktualisiert. Daher ist es nicht erforderlich, Element.getElementsByTagName() wiederholt mit demselben Element und denselben Argumenten aufzurufen, wenn sich das DOM zwischen den Aufrufen ändert.

Wenn getElementsByTagName auf ein HTML-Element in einem HTML-Dokument aufgerufen wird, wird das Argument vor dem Suchen in Kleinschreibung konvertiert. Dies ist unerwünscht, wenn versucht wird, camel-cased SVG-Elemente (wie etwa <linearGradient>) in einem HTML-Dokument zu finden. Stattdessen sollte Element.getElementsByTagNameNS() verwendet werden, das die Groß- und Kleinschreibung des Tag-Namens beibehält.

Element.getElementsByTagName ist ähnlich wie Document.getElementsByTagName(), außer dass es nur nach Elementen sucht, die Nachfahren des spezifizierten Elements sind.

Syntax

js
getElementsByTagName(tagName)

Parameter

tagName

Der qualifizierte Name, der gesucht werden soll. Der spezielle String "*" repräsentiert alle Elemente. Zur Kompatibilität mit XHTML sollte Kleinschreibung verwendet werden.

Rückgabewert

Eine lebendige HTMLCollection von Elementen mit einem passenden Tag-Namen in der Reihenfolge, in der sie erscheinen. Wenn keine Elemente gefunden werden, ist die HTMLCollection leer.

Beispiele

js
// Check the status of each data cell in a table
const table = document.getElementById("forecast-table");
const cells = table.getElementsByTagName("td");

for (const cell of cells) {
  const status = cell.getAttribute("data-status");
  if (status === "open") {
    // Grab the data
  }
}

Spezifikationen

Specification
DOM Standard
# dom-element-getelementsbytagname

Browser-Kompatibilität

BCD tables only load in the browser