WaBis

walter.bislins.ch

Makro: form option

Das Makro form option erzeugt ein Drop-Down-Auswahlfeld.

Anwendung

{{form option|Name|Zeilen|Auswahl-Liste|Flags|Wert}}
Name
Name des Auswahl-Feldes. Namen dürfen nur Buchstaben und Zahlen aus dem ASCII-Zeichen Vorrat enthalten. Das erste Zeichen muss ein Buchstabe sein. Jeder Name darf auf einer Seite nur einmal vorkommen.
Zeilen
Gibt an, wie viele Einträge gleichzeitig dargestellt werden sollen. Verwende 0 oder 1 für eine Drop-Down-Liste. Bei Zeilen > 1 wird das Feld entsprechend gross dargestellt. Wenn nötig wird ein Scrollbar angezeigt, um alle Einträge einsehen zu können.
Auswahl-Liste
Liste von Einträgen, aus denen einer gewählt werden kann. Die Elemente der Liste müssen mit \| voneinander getrennt werden. Ein Listeneintrag hat das Format Text = Wert. Wird Wert nicht explizit angegeben, wird implizit Text als Wert verwendet.
Flags (optional)
Angaben wie Klasse, Styles für den Textfeld usw. (siehe Form-Flags).
Wert
Bestimmt, welcher Eintrag der Auswahl-Liste als ausgewählt dargestellt werden soll.

Beispiele

Das folgende Beispiel zeigt eine Auswahl von 3 Städtenamen an:

{{form option|Stadt|1| Zürich \| Bern \| Luzern |Bern}}

So sieht das Feld aus:

Das Auswahlfeld Stadt enthält die Elemente Zürich, Bern und Luzern, wobei Bern selektiert ist.

Den Elementen können beliebige Werte (Zahlen oder Strings) zugewiesen werden. Selektiert wird ein Element immer über den Wert eines Elementes, nicht über seinen angezeigten Text:

{{form option|UserTyp|1| Neues Mitglied=3 \| Ehemaliges Mitglied=2 \| Gast=1 |2}}

So sieht es aus:

Dasselbe Eingabefeld kann auch mehrzeilig dargestellt werden:

{{form option|UserTyp|3| Neues Mitglied=3 \| Ehemaliges Mitglied=2 \| Gast=1 |2}}

Auswertung

Beim Absenden des Formulars, das ein Auswahlfeld enthält, wird der Wert des selektierten Eintrages unter dem Namen des Auswahlfeldes gespeichert. Dieser Wert kann auf der auswertenden Seite per WScript über die Funktion ReqForm abgefragt werden:

<wscript>
userTyp = ReqForm("UserTyp")
</wscript>

Ist wie im obigen Beispiel Ehemaliges Mitglied angewählt, bekommt userTyp den Wert "2" (String).

Weitere Infos zur Seite
Erzeugt Montag, 26. Oktober 2009
von wabis
Zum Seitenanfang
Geändert Samstag, 18. Juli 2015
von wabis