FENSTERNAME.document.forms[ ] / FORMULARNAME
Allgemeines zur Verwendung
Eigenschaften
Methoden
Allgemeines zur Verwendung
Mit dem Objekt FENSTERNAME.document.forms[ ] / FORMULARNAME haben Sie Zugriff auf alle Formulare, die in einer HTML-Datei definiert sind. Sie können Eingaben des Anwenders kontrollieren und Inhalte von Formularfeldern dynamisch verändern.
Weil die Verarbeitung von Formularen zu den komplexesten Bereichen von JavaScript gehört, gibt es für alle einzelnen Formularelemente wie Eingabefelder, Auswahllisten, Buttons usw. eigene Unterobjekte. Diese werden im vorliegenden Dokument bei FENSTERNAME.document.forms[ ] / FORMULARNAME.elements[ ] / ELEMENTNAME beschrieben. Das Objekt FENSTERNAME.document.forms[ ] / FORMULARNAME stellt dagegen allgemeine Eigenschaften und Methoden zur Verfügung, die ein Formular im ganzen betreffen.
Eine Objektinstanz des Formular-Objekts wird automatisch erzeugt, wenn der WWW-Browser mindestens ein Formular in der HTML-Datei vorfindet.
Schema 1 / Beispiel 1:
FENSTERNAME.document.forms[#].Eigenschaft/Methode()
window.document.forms[0].submit()
|
Schema 2 / Beispiel 2:
FENSTERNAME.document.FORMULARNAME.Eigenschaft/Methode()
window.document.Anmeldung.submit()
|
Erläuterung:
Formulare einer HTML-Datei können Sie auf zwei Arten ansprechen:
- mit einer Indexnummer (wie in Schema 1 / Beispiel 1)
Bei Verwendung von Indexnummern geben Sie forms an und dahinter in eckigen Klammern, das wievielte Formular innerhalb der HTML-Datei Sie meinen. Beachten Sie, daß der Zähler bei 0 beginnt, d.h. das erste Formular sprechen Sie mit forms[0] an, das zweite Formular mit forms[1] usw. Beim Zählen gilt die Reihenfolge, in der die Formulare in der HTML-Datei definiert sind.
- mit dem Namen des Formulars (wie in Schema 2 / Beispiel 2)
Dabei geben Sie den Namen an, der bei der Definition des Formulars bei <form ...> in der Zusatzangabe name= definiert worden ist.
Beachten Sie:
Zu den Fensternamen lesen Sie den Abschnitt Allgemeines zur Verwendung des window-Objekts. Bei Verwendung von Frames lesen Sie auch den Abschnitt Allgemeines zur Verwendung des Frame-Objekts.
Eigenschaften
FENSTERNAME.document.forms[#].action
FENSTERNAME.document.FORMULARNAME.action
Wert, der bei der Definition des Formulars in der Zusatzangabe action steht.
FENSTERNAME.document.forms[#].encoding
FENSTERNAME.document.FORMULARNAME.encoding
Kodierungstyp des Formulars. Nühere Information hierzu gibt es im WWW in der Spezifikation RFC 1867 .
FENSTERNAME.document.forms.length
Ermittelt die Anzahl der Formulare, die in einer HTML-Datei definiert sind.
FENSTERNAME.document.forms[#].name
FENSTERNAME.document.FORMULARNAME.name
Wert, der bei der Definition des Formulars in der Zusatzangabe name steht.
FENSTERNAME.document.forms[#].method
FENSTERNAME.document.FORMULARNAME.method
Wert, der bei der Definition des Formulars in der Zusatzangabe method steht.
FENSTERNAME.document.forms[#].target
FENSTERNAME.document.FORMULARNAME.target
Wert, der bei der Definition des Formulars in der Zusatzangabe target steht.
Methoden
FENSTERNAME.document.forms[#].reset()
FENSTERNAME.document.FORMULARNAME.reset()
Löscht alle Eingaben in einem Formular und hat damit den gleichen Effekt wie ein Mausklick auf einen Button vom Typ "reset".
FENSTERNAME.document.forms[#].submit()
FENSTERNAME.document.FORMULARNAME.submit()
Sendet das Formular ab und hat damit den gleichen Effekt wie ein Mausklick auf einen Button von Typ "submit".
© 1997 Stefan Münz, s.muenz@euromail.com