Das Makro form textarea definiert ein mehrzeiliges Textfeld.

Anwendung

{{form textarea|Name|NZeilen|Flags|Wert}}

Name

Name und ID des unsichtbaren 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.

NZeilen: Zahl > 0

Anzahl Zeilen des mehrzeiligen Textfeldes. Es muss ein Wert grösser als Null angegeben werden. Die Breite des Feldes und weitere Stil-Elemente können mit CSS oder Style-Angaben in Flags definiert werden.

Flags (optional)

Angaben wie Klasse, Styles für den Textfeld usw. (siehe Form-Flags). Soll das Textfeld die Breite des Browser-Fensters einnehmen, sieht ein entsprechender Style folgendermassen aus: Flags = style=width:100%

Wert

Text (String) des Textfeldes.

Textarea-Felder sind mehrzeilige 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.

Beispiel

Im fogenden Beispiel kann auf der Seite Ihr Kommentar der Benutzer einen Kommentar eingeben. Beim Klicken auf den Button Weiter wird die Seite Kontrolle aufgerufen, wo die Eingaben des Benutzers verarbeitet werden, in diesem Fall auf der Seite ausgegeben wird.

Seite Ihr Kommentar

{{form|[[Kontrolle]]}}

Schreiben Sie hier ihren Kommentar:

{{form textarea|Kommentar|10|style=width:100%|}}

{{form button|Action|Weiter}}
{{end form}}

Seite Kontrolle

Folgenden Text haben Sie eingegeben:

{{ReqForm|Kommentar}}

Spezialzeichen in Form-Elementen

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>