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 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
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
// 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