Dokumentation: form

Erzeugt ein Formular zur Eingabe von Daten durch den WGA-Benutzer.

Vererbte WebTML-Attributes sind ausgeblendet -> Anzeigen
Name	Wert(e)	Verwendung
cssclass	CSS-Klasse	Bestimmt die CSS-Klasse welche das Rendering des HTML-Formulars im Browser steuert. Der Inhalt dieses Attributes wird direkt in das "class"-Attribut des HTML-Form-Tags kopiert.
cssstyle	CSS-Styleinformationen
defaultaction	Aktions-ID	Gibt eine WebTML-Aktion an die ausgeführt wird wenn das WebTML-Formular per normalem Browser-Submit abgeschickt wird
editable	false \| true	Definiert, ob die Formulardaten nur angezeigt oder bearbeitet werden können.
htmlinput	true\|false	Bestimmt, ob normale HTML-Inputfelder vom WebTML-Formular akzeptiert werden.
id	ID des Formulars	ID des Formulars. Pflichtattribut bei tml:form.
mode	edit\|readonly\|view	Bestimmt den Darstellungsmodus des WebTML-Formulars.
onsubmit	JavaScript-Code	Fügt den angegebenen JavaScript-Code in das Event "onsubmit" der HTML-Form ein. Dieses wird bei jedem Versand des Formulars zuvor ausgeführt um z.B. Eingabevalidierungen durchzuführen.
persist	true\|false	Markiert eine Form als "persistent". Persistente Formulare speichern ihre Werte serverseitig zwischen. Diese Werte sind auch dann noch verfügbar, wenn der Benutzer zwischenzeitig Seiten besucht, die das Formular nicht enthalten. Daher eignen sich persistente Formulare für das Sammeln von Daten über diverse Requests einer Session hinweg wie z.B. bei Einkaufs-Warenkörben. Ein persistentes Formular kann in TMLScript jederzeit über "this.tmlformByID(id)" adressiert und bearbeitet werden, auch wenn es NICHT im letzten Request verschickt wurde oder auf der aktuellen Seite gerendert wurde. Die Daten einer persistenten TML-Form werden nur in zwei Fällen gelöscht: - Per TMLScript wird die TML-Form-Methode "reset" ausgelöst, welche die Daten gesteuert löscht - Die Server-Session des Benutzers geht verloren
source	content \| profile \| portlet \| none	Datenquelle der Formulardaten

<tml:form> erzeugt zur Laufzeit HTML der Art:

<form methode=post" id="myform" action="URL zur gleichen Seite">... </form>

Im Inhalt des tml:form-Tag werden input-Tags definiert, welche die einzelnen Eingabefelder definieren. Diese werden, je nach source-Attribut des tml:form-Tags, automatisch aus den Daten des aktuellen Inhaltsdokumentes, des Benutzerprofils oder der Portletkonfiguration gefüllt, oder beziehen ihre Daten lediglich über den WGA-Benutzer.

Anders als HTML-Formulare werden WebTML-Formulare nicht automatisch gespeichert, wenn sie per Submit an den Server übermittelt werden. Stattdessen werden WebTML-Aktionen benutzt, um die Formulardaten, welche serverseitig durch das TMLScript-Objekt "tmlform" repräsentiert werden, in einem Inhaltsdokument oder dem Benutzerprofil zu speichern oder sie anderweitig zu verwenden.

Folgenes simples WebTML-Formular bietet ein Eingabefeld "name". Über die per <tml:url> definierte Inline-Aktion wird der Inhalt des Formulars im Benutzerprofil gespeichert.

<tml:form source="profile" id="myform">

</tml:form>

Nachfolgend ein Beispiel für einen HTML File-Upload, der anschliessen an ein Content-Dokument angehangen werden soll:

<tml:action id="save">

this.tmlform.attach( this.content() );

</tml:action>

<tml:form id="Upload">

File Upload<br>

<tml:input type="file" name="FileUpload"> size="80" </tml:input><br>

<a href="<tml:url type="action" action="save"/>">Im Content-Dokument speichern</a>

</tml:form>
</tml:form>