HTMLDocument.getElementsByName( )

Sucht Elemente mit dem angegebenen name-Attribut

---

Überblick

Element[] getElementsByName(String elementName);

Argumente

elementName

Der gewünschte Wert für das name-Attribut.

Rückgabewert

Ein schreibgeschütztes Array (technisch gesehen eine NodeList) von Element-Objekten, die ein Attribut name mit dem angegebenen Wert haben. Wenn keine solchen Elemente vorhanden sind, ist das zurückgegebene Array leer und hat die length 0.

Beschreibung

Diese Methode sucht in einem HTML-Dokumentenbaum Element-Knoten, deren name-Attribut den angegebenen Wert hat, und gibt eine NodeList (die Sie auch als schreibgeschütztes Array behandeln können) mit allen passenden Elementen zurück. Wenn keine passenden Elemente vorhanden sind, wird eine NodeList mit der length 0 zurückgegeben.

Verwechseln Sie diese Methode nicht mit der Methode Document.getElementById(), die ein einzelnes Element anhand des eindeutigen Werts eines id-Attributs sucht, oder mit der Methode Document.getElementsByTagName(), die eine NodeList mit Elementen zurückgibt, die den angegebenen Tag-Namen haben.

Siehe auch

Document.getElementById( ), Document.getElementsByTagName( )