Formularelemente-Sammlung

Definition und Verwendung

elements Die Sammlung gibt die Sammlung aller Elemente im Formular zurück.

Anmerkung:Die Elemente in der Sammlung werden in der Reihenfolge ihrer im Quellcode angezeigten Position sortiert.

Anmerkung:Die elements-Sammlung gibt alle Elemente im <form>-Element zurück, nicht alle <form>-Elemente im Dokument. Um alle <form>-Elemente im Dokument zu erhalten, verwenden Sie bitte document.forms-Sammlung.

Beispiel

Beispiel 1

Finde heraus, wie viele Elemente im angegebenen <form>-Element vorhanden sind:

var x = document.getElementById("myForm").elements.length;

Probieren Sie es selbst aus

Das Ergebnis von x wird sein:

3

Hinweis:Mehr Beispiele finden Sie am Ende der Seite.

Syntax

formObject.elements

Eigenschaft

Eigenschaft Beschreibung
length

Gibt die Anzahl der Elemente im <form>-Element zurück.

Anmerkung:Dieser Eigenschaft ist schreibgeschützt.

Methode

Methode Beschreibung
[index]

Gibt das Element im <form> zurück, das den angegebenen Index hat (beginnend mit 0).

Anmerkung:Wird der Index außerhalb des Bereichs, wird null zurückgegeben.

item(index)

Gibt das Element im <form> zurück, das den angegebenen Index hat (beginnend mit 0).

Anmerkung:Wird der Index außerhalb des Bereichs, wird null zurückgegeben.

namedItem(id)

Gibt das Element im <form> zurück, das den angegebenen id hat.

Anmerkung:Wird id nicht gefunden, wird null zurückgegeben.

Technische Details

DOM-Version: Core Level 2 Document Object
Rückgabewert:

HTMLFormsControlCollection-Objekt, das alle Elemente im <form>-Element darstellt.

Die Elemente im Set sind nach ihrer Reihenfolge im Quellcode sortiert.

Mehr Beispiele

Beispiel 2: [index]

Erhalte den Wert des ersten Elements im Formular (Index 0):

var x = document.getElementById("myForm").elements[0].value;

Probieren Sie es selbst aus

Das Ergebnis von x wird sein:

Donald

Beispiel 3: item(index)

Erhalte den Wert des ersten Elements im Formular (Index 0):

var x = document.getElementById("myForm").elements.item(0).value;

Probieren Sie es selbst aus

Das Ergebnis von x wird sein:

Donald

Beispiel 4: namedItem(id)

Erhalte den Wert des Elements mit name="fname" im Formular:

var x = document.getElementById("myForm").elements.namedItem("fname").value;

Probieren Sie es selbst aus

Das Ergebnis von x wird sein:

Donald

Beispiel 5

Durchlaufe alle Elemente im Formular und gebe den Wert jedes Elements aus:

var x = document.getElementById("myForm");
var txt = "";
var i;
for (i = 0; i < x.length; i++) {
  txt = txt + x.elements[i].value + "<br>";
}
document.getElementById("demo").innerHTML = txt;

Probieren Sie es selbst aus

Das Ergebnis von x wird sein:

Donald
Duck
Submit

Browser-Unterstützung

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
Unterstützung Unterstützung Unterstützung Unterstützung Unterstützung