HTML DOM Dokument getElementsByName() Methode

Definition und Verwendung

getElementsByName() Methode gibt eine Sammlung von Elementen mit angegebenem Namen zurück.

getElementsByName() Die Methode gibt eine Echtzeit- NodeList.

NodeList

NodeList Ist eine ähnliche Knotensammlung (Liste) wie ein Array.

Knoten in der Liste können über Index erreicht werden. Der Index beginnt bei 0.

length Rückgabeliste der Eigenschaften, Anzahl der Knoten.

Bitte lesen Sie auch:

getElementById()-Methode

getElementsByTagName()-Methode

getElementsByClassName()-Methode

querySelector()-Methode

querySelectorAll()-Methode

NodeList-Referenzhandbuch

Beispiel

Beispiel 1

Alle Elemente mit dem Namen "fname" abrufen:

let elements = document.getElementsByName("fname");

Selbst ausprobieren

Beispiel 2

Gibt die Anzahl der Elemente mit name="animal" zurück:

let num = document.getElementsByName("animal").length;

Selbst ausprobieren

Beispiel 3

Überprüfen Sie alle <input>-Elemente mit type="checkbox" und dem Namen "animal":

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

Selbst ausprobieren

Syntax

document.getElementsByName(name)

Parameter

Parameter Beschreibung
name Erforderlich. Wert der Elementeigenschaft name.

Rückgabewert

Typ Beschreibung
Objekt

NodeList-Objekt.

Sammlung von Elementen mit angegebenem Namen.

Sortiert nach der Reihenfolge, in der die Elemente im Dokument auftreten.

Browserunterstützung

document.getElementsByName() Es ist eine Eigenschaft von DOM Level 1 (1998).

Es wird von allen Browsern unterstützt:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Unterstützung 9-11 Unterstützung Unterstützung Unterstützung Unterstützung