Das Makro form text definiert ein Textfeld.
Anwendung
{{form text|Name|Flags|Wert}}
Textfelder sind einzeilige Eingabefelder auf einer Webseite. Jedes Textfeld hat einen eindeutigen Namen. Die Eingaben des Anwenders werden beim anklicken eines Buttons unter diesem Namen an eine verarbeitende Seite geschickt. Dort können die Eingaben mit der Funktion ReqForm abgefragt und weiter verarbeitet werden.
Note: Das Textfeld erhält dieselbe HTML-ID wie den Namen. Das Flag id=html-ID muss daher nicht verwendet werden.
Im fogenden Beispiel kann auf der Seite Ihre Daten der Benutzer seinen Vor- und Nachnamen eingeben. Beim Klicken auf den Button Weiter wird die Seite Hallo aufgerufen, wo die Eingaben des Benutzers verarbeitet werden, in diesem Fall auf der Seite ausgegeben werden.
Seite Ihre Daten
{{form|[[Hallo]]}} {| | Vorname: || {{form text|Vorname|}} |- | Nachname: || {{form text|Nachname|}} |- | || {{form button|Action|Weiter}} |} {{end form}}
Seite Hallo
Hallo {{ReqForm|Vorname}} {{ReqForm|Nachname}}! :
Spezialzeichen in Werten von Form-Elementen (form hidden, form text, form textarea) müssen im Wiki-Text mit \ maskiert werden. Wenn der Wert per Wscript zugewiesen wird, muss er mit der Funktion FormString entsprechend maskiert werden:
<wscript> dim text text = "Ein Text mit Spezialzeichen..." Writeln "{{form text|Name1|" & FormString(text) & "}}" </wscript>
Wenn der Wert vom selben oder einem anderen Textfeld verwendet werden soll, so geht das folgendermassen:
<wscript> Writeln "{{form text|Name1|" & FormString(ReqForm("Name2")) & "}}" </wscript>
oder einfacher (und effizienter):
<wscript> Writeln "{{form text|Name1|" & FormValue("Name2") & "}}" </wscript>
Die Funktion FormValue kann auch per Makro gerufen werden:
<wscript> Writeln "{{form text|Name1|{{FormValue|Name2}}}}" </wscript>