Dokumentation: getElementsByName() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2018 browserübergreifend verfügbar.
Die getElementsByName() Methode
des Document Objekts gibt eine NodeList Sammlung von
Elementen mit einem bestimmten name Attribut im Dokument zurück.
Syntax
getElementsByName(name)
Parameter
name-
Der Wert des
nameAttributs der Elemente, nach denen wir suchen.
Rückgabewert
Eine dynamische NodeList Sammlung, was bedeutet, dass sie automatisch aktualisiert wird, wenn neue Elemente mit demselben name zum Dokument hinzugefügt oder daraus entfernt werden.
Beispiele
<!doctype html>
<html lang="en">
<head>
<title>Example: using document.getElementsByName</title>
</head>
<body>
<input type="hidden" name="up" />
<input type="hidden" name="down" />
</body>
</html>
const upNames = document.getElementsByName("up");
console.log(upNames[0].tagName); // displays "INPUT"
Hinweise
Das name Attribut kann nur in (X)HTML
Dokumenten angewendet werden.
Die zurückgegebene NodeList Sammlung enthält alle Elemente mit dem
angegebenen name, wie z.B. <meta>, <object>, und
sogar Elemente, die das name Attribut überhaupt nicht unterstützen.
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-document-getelementsbyname-dev |
Browser-Kompatibilität
Siehe auch
document.getElementById()um eine Referenz auf ein Element anhand seiner eindeutigenidzurückzugebendocument.getElementsByTagName()um Referenzen auf Elemente mit demselben Tag-Namen zurückzugebendocument.querySelector()um Referenzen auf Elemente mittels CSS Selektoren wie'div.myclass'zurückzugeben