Element: getElementsByTagName()-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.getElementsByTagName()-Methode gibt eine dynamische HTMLCollection von Elementen mit dem angegebenen Tag-Namen zurück.

Alle Nachfahren des angegebenen Elements werden durchsucht, jedoch nicht das Element selbst. Die zurückgegebene Liste ist dynamisch, das heißt, sie aktualisiert sich automatisch mit dem DOM-Baum. Daher ist es nicht erforderlich, Element.getElementsByTagName() mit dem gleichen Element und den gleichen Argumenten wiederholt aufzurufen, wenn sich das DOM zwischen den Aufrufen ändert.

Wenn diese Methode auf ein HTML-Element in einem HTML-Dokument angewendet wird, wird das Argument von getElementsByTagName vor der Suche in Kleinbuchstaben umgewandelt. Dies ist unerwünscht, wenn versucht wird, camel-cased SVG-Elemente (wie z.B. <linearGradient>) in einem HTML-Dokument zu matchen. Stattdessen sollte Element.getElementsByTagNameNS() verwendet werden, das die Groß- und Kleinschreibung des Tag-Namens beibehält.

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

Syntax

js
getElementsByTagName(tagName)

Parameter

tagName

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

Rückgabewert

Eine dynamische 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
# dom-element-getelementsbytagname

Browser-Kompatibilität