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;
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;
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;
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;
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;
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 |