Document: getElementsByName()-Methode

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

html

<!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 Standard # dom-document-getelementsbyname-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

document.getElementById(), um eine Referenz zu einem Element anhand seiner eindeutigen id zurückzugeben
document.getElementsByTagName(), um Referenzen zu Elementen mit demselben Tag-Name zurückzugeben
document.querySelector(), um Referenzen zu Elementen über CSS-Selektoren wie 'div.myclass' zurückzugeben