Document: getElementsByName()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2018.
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
name-Attributs des Elements oder der Elemente, die wir suchen.
Rückgabewert
Eine Live-NodeList-Sammlung, das heißt, sie wird automatisch aktualisiert, wenn neue Elemente mit demselben name hinzugefügt oder 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 up_names = document.getElementsByName("up");
console.log(up_names[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 gegebenen name, wie z.B. <meta>, <object>, und sogar Elemente, die das name-Attribut überhaupt nicht unterstützen.
Spezifikationen
| Specification |
|---|
| HTML # dom-document-getelementsbyname-dev |
Browser-Kompatibilität
Loading…
Siehe auch
document.getElementById(), um eine Referenz zu einem Element anhand seiner eindeutigenidzurückzugebendocument.getElementsByTagName(), um Referenzen zu Elementen mit demselben Tag-Name zurückzugebendocument.querySelector(), um Referenzen zu Elementen über CSS-Selektoren wie'div.myclass'zurückzugeben