HTML-Dateien selbst erstellen
	Dokumentation: JavaScript
		JavaScript-Objektreferenz

FENSTERNAME.document.forms[ ] / FORMULARNAME.elements[ ] / ELEMENTNAME

Allgemeines zur Verwendung
Eigenschaften
Methoden

Allgemeines zur Verwendung

Hinter FENSTERNAME.document.forms[ ] / FORMULARNAME.elements[ ] / ELEMENTNAME verbergen sich mehrere Objekte. So gibt es Objekte für Eingabefelder, Auswahllisten, verschiedene Arten von Buttons. Alle diese Objekte werden jedoch im sogenannten "elements-Array" zusammengesfaßt. Alle diese Objekte werden auf die gleiche Art und Weise angesprochen. Sie unterscheiden sich lediglich in ihren Eigenschaften und Methoden. Bei den Eigenschaften und Methoden in diesem Abschnitt ist daher immer vermerkt, für welche Objekte sie gelten. Folgende Angaben werden dabei unterschieden:

Eingabefeld Auswahlliste Button Gruppen-Button[#]

Eine Objektinstanz des Formularelement-Objekts wird automatisch erzeugt, wenn der WWW-Browser mindestens ein Formular mit mindestens einem Element in der HTML-Datei vorfindet.

Schema 1 / Beispiel 1:

FENSTERNAME.document.forms[#].elements[#].Eigenschaft/Methode();
window.document.forms[0].elements[2].checked = true;

Schema 2 / Beispiel 2:

FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.Eigenschaft/Methode()
x = window.document.Anmeldung.Anschrift.text;
window.document.Anmeldung.Geschlecht[1].checked = true;

Erläuterung:

Elemente in Formularen können Sie auf zwei Arten ansprechen:

mit einer Indexnummer (wie in Schema 1 / Beispiel 1)
Bei Verwendung von Indexnummern geben Sie elements an und dahinter in eckigen Klammern, das wievielte Element innerhalb des zuvor bestimmten Formulars innerhalb der HTML-Datei Sie meinen. Beachten Sie, daß der Zähler bei 0 beginnt, d.h. das erste Formularelement sprechen Sie mit elements[0] an, das zweite Formular mit elements[1] usw. Beim Zählen gilt die Reihenfolge, in der die Formularelemente definiert sind. Bei mehreren zusammengehörigen Elementen wie Radio- oder Checkbuttons hat jedes ankreuzbare Element eine fortlaufende Indexnummer.
mit dem Namen des Formularelements (wie in Schema 2 / Beispiel 2)
Dabei geben Sie den Namen an, der bei der Definition des Formularelements in der Zusatzangabe name= definiert worden ist. Wenn Sie Formularelemente mit Namen ansprechen, müssen Sie bei Elementen, die eine geschlossene Gruppe bilden, wie Radio- oder Checkbuttons oder auch Optionen einer Auswahlliste, eine Indexnummer hinter dem Elementnamen angeben (siehe unterstes der obigen Beispiele). Das ist auch logisch, da solche Elemente ja jeweils den gleichen Namen haben. Das erste Element einer solchen Gruppe sprechen Sie mit Elementname[0] an, das zweite mit Elementname[1] usw.

Beachten Sie:

Das Ansprechen über Indexnummern und Namen können Sie selbstverständlich auch mischen. So ist es beispielsweise möglich, das Formular selbst über seine Indexnummer anzusprechen, einzelne Elemente dieses Formulars dagegen mit ihren Namen. Es dient lediglich der Einfachheit, daß hier entweder alles mit Indexnummern oder alles mit Namen angesprochen wird.

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. Das den Formularelementen übergeordnete Formularobjekt wird im Abschnitt FENSTERNAME.document.forms[#] / FORMULARNAME beschrieben.

Eigenschaften

FENSTERNAME.document.forms[#].elements[#].checked
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME[#].checked
Lesen Ändern Gruppen-Button[#]
Ermittelt bzw. bestimmt, ob bzw. daß ein Radio- oder Checkbutton aktiviert ist oder nicht. Mögliche Werte sind true bzw. 1 oder false bzw. 0. Beispiel: if(document.Favoritenformular.Alter[0].checked == true) alert("Sind Sie wirklich so jung?");. In dem Beispiel ist Alter der gemeinsame Name einer Gruppe von Radiobuttons im HTML-Formular.

FENSTERNAME.document.forms[#].elements[#].defaultChecked
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME[#].defaultChecked
Lesen Ändern Gruppen-Button[#]
Ermittelt bzw. bestimmt, ob bzw. daß ein Radio- oder Checkbutton per Voreinstellung aktiviert ist oder nicht. Mögliche Werte sind true bzw. 1 oder false bzw. 0. Beispiel: document.forms[0].Zutaten[3].defaultChecked = true;. In dem Beispiel ist Zutaten der gemeinsame Name einer Gruppe von Checkbuttons im HTML-Formular.

FENSTERNAME.document.forms[#].elements[#].defaultValue
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.defaultValue
Lesen Ändern Eingabefeld
Ermittelt oder bestimmt den voreingestellten Text eines Eingabefeldes. Beispiel: document.Favoritenformular.Kommentar.defaultValue = "Lassen Sie sich was einfallen!");.

FENSTERNAME.document.forms[#].elements.length
FENSTERNAME.document.FORMULARNAME.elements.length
Lesen
Anzahl der Elemente in dem entsprechenden Formular.

FENSTERNAME.document.forms[#].elements[#].name
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.name FENSTERNAME.document.FORMULARNAME.ELEMENTNAME[#].name
Lesen Eingabefeld Auswahlliste Button Gruppen-Button[#]
Der Name des Formularelements, wie er in HTML bei der Definition des Elements mit der Zusatzangabe name= zugewiesen wurde. Wenn Sie beispielsweise in einer HTML-Datei <form name=TestForm><input name=Eingabefeld onFocus="window.status=TestForm.Eingabefeld.name; return true"></form> notieren, wird dem Anwender während der Eingabe in dem Feld der Name des Elements angezeigt.

FENSTERNAME.document.forms[#].elements[#].options[#].index
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.options[#].index
Lesen Auswahlliste
Ermittelt den Index einer Auswahlmöglichkeit. Beispielsweise wird bei var x = document.forms[0].favorit.options[3].index in der Variablen x der Wert 3 gespeichert, weil dies bei ...options[3] der Index ist.

FENSTERNAME.document.forms[#].elements[#].options.length
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.options.length
Lesen Auswahlliste
Ermittelt die Anzahl der Auswahlmöglichkeiten in einer Auswahlliste.

FENSTERNAME.document.forms[#].elements[#].options[#].defaultSelected
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.options[#].defaultSelected
Lesen Ändern Auswahlliste
Ermittelt bzw. bestimmt, ob bzw. daß eine Auswahlmöglichkeit in einer Auswahlliste per Voreinstellung aktiviert ist oder nicht. Mögliche Werte sind true bzw. 1 oder false bzw. 0. Beispiel: document.Musikform.Favoriten.options[2].defaultSelected = true;. In dem Beispiel ist Favoriten der Name einer Auswahlliste mit Musikern.

FENSTERNAME.document.forms[#].elements[#].options.selectedIndex
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.options.selectedIndex
Lesen Ändern Auswahlliste
Ermittelt oder bestimmt, welche Auswahlmöglichkeit in einer Auswahlliste aktiviert ist. Beispiel: document.Musikform.Favoriten.options.selectedIndex = 3;. In dem Beispiel ist Favoriten der Name einer Auswahlliste mit Musikern.

FENSTERNAME.document.forms[#].elements[#].options[#].selected
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.options[#].selected
Lesen Ändern Auswahlliste
Ermittelt oder bestimmt, welche Auswahlmöglichkeit in einer Auswahlliste aktiviert ist. Mögliche Werte sind true bzw. 1 oder false bzw. 0. Beispiel: document.Musikform.Favoriten.options[3].selected = true;. In dem Beispiel ist Favoriten der Name einer Auswahlliste mit Musikern. Mit options[3].selected = true wird die vierte Auswahlmöglichkeit ausgewählt.

FENSTERNAME.document.forms[#].elements[#].options[#].text
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.options[#].text
Lesen Ändern Auswahlliste
Ermittelt oder bestimmt den Text einer Auswahlmöglichkeit in einer Auswahlliste. Beispiel: alert(document.Musikform.Favoriten.options[3].text). Das Beispiel gibt den Text zur vierten Auswahlmöglichkeit in der Auswahlliste Favoriten innerhalb des Formulars Musikform am Bildschirm aus.

FENSTERNAME.document.forms[#].elements[#].value
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.value FENSTERNAME.document.FORMULARNAME.ELEMENTNAME[#].value
Lesen Ändern Eingabefeld Auswahlliste Button Gruppen-Button[#]
Wert, den der Anwender in einem Formularelement eingegeben bzw. diesem zugewiesen hat. Wenn Sie beispielsweise in einer HTML-Datei <form name=TestForm><input name=Eingabefeld><input type=submit name=OK value="Anzeigen" onClick="alert(document.TestForm.Eingabefeld.value)"></form> notieren, kann der Anwender in einem Eingabefeld etwas eingeben. Wenn er anschließend auf den Button "Anzeigen" klickt, wird der eingegebene Text in einem Meldungsfenster am Bildschirm angezeigt.

Methoden

FENSTERNAME.document.forms[#].elements[#].blur()
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.blur()
Eingabefeld Auswahlliste
Die Methode entfernt den Cursor bzw. den Focus von dem betreffenden Feld bzw. der Auswahlliste. Wenn Sie beispielsweise ein Formular mit Namen TesteDeinWissen mit einem Eingabefeld WannStarbGoethe haben, dann können Sie z.B. mit CountDown=window.setTimeout("document.TesteDeinWissen.WannStarbGoethe.blur()",10000); den Cursor nach 10 Sekunden automatisch aus dem Feld entfernen.

FENSTERNAME.document.forms[#].elements[#].click()
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.click() FENSTERNAME.document.FORMULARNAME.ELEMENTNAME[#].click()
Button Gruppen-Button[#]
Die Methode erzeugt einen automatischen Klick auf den betreffenden Button. Wenn Sie beispielsweise ein Formular mit Namen TesteDeinWissen haben, bei dem der Submit-Button das 9. Element ist, dann können Sie z.B. mit CountDown=window.setTimeout("document.TesteDeinWissen.elements[8].click()",60000); nach einer Minute ein automatisches Abschicken des Formulars erzwingen.

FENSTERNAME.document.forms[#].elements[#].focus()
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.focus()
Eingabefeld Auswahlliste
Die Methode setzt den Cursor bzw. den Focus auf das betreffende Feld bzw. die Auswahlliste. Wenn Sie beispielsweise ein Formular mit Namen TesteDeinWissen mit einem Eingabefeld WannStarbGoethe haben, dann können Sie z.B. mit document.TesteDeinWissen.WannStarbGoethe.focus(); den Cursor in dieses Feld setzen.

FENSTERNAME.document.forms[#].elements[#].select()
FENSTERNAME.document.FORMULARNAME.ELEMENTNAME.select()
Eingabefeld
Die Methode selektiert den gesamten in dem Feld enthaltenen Text. Wenn Sie beispielsweise ein Formular mit Namen TesteDeinWissen mit einem Eingabefeld WannStarbGoethe mit dem Default-Text 1996 haben, dann können Sie z.B. mit document.TesteDeinWissen.WannStarbGoethe.select(); den Default-Text selektieren, um dem Anwender zu signalisieren, daß er den Default-Text mit der richtigen Jahreszahl überschreiben soll.

Blättern:

FENSTERNAME.document.forms[ ] / FORMULARNAME FENSTERNAME.document.images[ ] / BILDNAME

HTML-Dateien selbst erstellen

Dokumentation: JavaScript

JavaScript-Objektreferenz

Stefan Münz, s.muenz@euromail.com

	Blättern:
FENSTERNAME.document.forms[ ] / FORMULARNAME			FENSTERNAME.document.images[ ] / BILDNAME