Webgate Anywhere 4.1 - WebTML Tag-Referenz
input

<tml:input>

Beschreibung :

Stellt Eingabefelder innerhalb von WebTML-Formularen zur Verfügung.
Abgeleitet von:
<tml:[Alle Tags]>
Nur verfügbar in folgenden übergeordneten Tags: Attribute:
Vererbte WebTML-Attributes sind ausgeblendet -> Anzeigen
Name Wert(e) Verwendung
ajax true|false|norefresh Nur verfügbar bei verwendung von changeaction="...": Markiert die Aktion bei Auswahlwechsel als AJAX-Aktion. Das Ausführen der Aktion wird nur das WebTML-Portlet, in welchem sich das Feld befindet, neu laden, nicht jedoch die gesamte Webseite.
changeaction ID einer WebTML-Aktion Angabe einer WebTML-Aktion, welche bei Änderung des Eingabefeldes automatisch ausgelöst wird.
cleariferror Feldname, Feldname, ... Enthält die Namen von WebTML-Form-Feldern, deren Inhalte gelöscht werden wenn die Validierung dieses tml:input-Tags fehlschlägt.
cssclass CSS-Klasse Gibt eine Stylesheetklasse an. Der Wert dieses Attributes wird direkt an das Attribut "class" des generierten HTML-Tags "input" übergeben.
cssstyle CSS-Styledefinitionen Gibt ein Stylesheet-Definiton an. Der Wert dieses Attributes wird direkt an das Attribut "style" des generierten HTML-Tags "input" übergeben.
default Beliebiger Stringwert Definiert einen Default-Wert der als Feldinhalt verwendet wird, wenn das Feld noch keinen Wert besitzt.
encodeoptions true | false Schaltet die automatische HTML-Enkodierung von Optionen an bzw. aus
focus true|false Setzt den Eingabefokus auf ein Eingabefeld
message Fehlermeldung Definiert Fehlermeldungen zum Validierungsausdruck in Attribut validation
meta true|false Gibt an, dass die Daten dieses Inputs nicht als Item im Dokument abgelegt werden sollen, sondern als Metadaten. Somit wird die Angabe im name-Attribut als Metaname interpretiert, so wie er auch im Tag <tml:metadata> verwendert wird.
Diese Funktion sollte mit grosser Sorgfalt verwendet werden, da sich bei unsachgemäßem Gebrauch die Daten-Integrität von WGA-Dokumenten zerstören kann.
mode edit|readonly|view Bestimmt den Darstellungsmodus des einzelnen Eingabefeldes.
multiple true|false Bestimmt bei type="select" ob das Eingabefeld es erlaubt, dass mehrere Werte markiert werden.
name itemname Bestimmt das Item bzw. bei meta="true" das Metadatenfeld, dessen Wert über das Input-Feld modifiziert werden kann.
options option1[|wert1],option2[|wert2], ... Definiert Auswahl-Optionen für das Eingabefeld
optionsitem Itemname Alternative zu Attribut options, in welcher Auswahl-Optionen für das Eingabefeld definiert werden
portletmode Portlet-Modus Setzt den Portlet-Modus nach Ausführung einer WebTML-Aktion
store true | false Markiert ein einzelnes Eingabefeld als nicht-persistent.
type="boolean" boolean Gib ein Eingabefeld für einen boolschen Wert aus
type="checkbox" Stellt das Eingabefeld als Liste von Markierungskästchen dar, welche die Optionen beinhalten die als Attribut options angegeben wurden.
type="file" file Bietet einen Dialog zum Hochladen einer Datei an.
type="hashedpassword" Generiert ein Textfeld mit maskierter Eingabe, dessen Inhalt gehasht wird und dessen Usprungswert somit nicht wiederherstellbar ist.
type="number|date" number|date Zeigt ein Eingabefeld zur Datums- oder Zahlen-Angabe an.
type="radio" Stellt das Eingabefeld als Liste von Auswahlkästchen dar, welche die Optionen beinhalten die als Attribut options angegeben wurden.
type="select|checkbox|radio" select Darstellung als Listbox.
Das Attribut "options" beinhaltet die Optionen der Listbox als kommaseparierte Liste.
Das Attribut "multiple" bestimmt, ob Mehrfachauswahl für das Feld aktiviert sein wird.
type="text|password|hidden" text|hidden|password Gibt ein normales HTML-Textfeld aus. Die Feldeingabe ist bei type="password" maskiert. Bei type="hidden" wird das Feld nicht angezeigt.
type="textarea" textarea Anzeige als mehrzeiliges Text-Eingabefeld vom HTML-Typ "textarea". Die HTML-Attribute "rows" und "cols" können sie im Body des Input-Tags spezifizieren.
Wenn multiple="true" gewählt ist, werden die einzelnen Zeilen der Textarea-Eingabe als einzelne Werte einer Wertliste aufbereitet und das Item als Mehrfachwertfeld in Dokumenten gespeichert.
validation TMLScript expression Definiert einen Validierungsausdruck, der bei Speicherung des Formulars ausgewertet wird.
validationdivider Trennzeichen Definiert ein Trennzeichen für Validierungsausdrücke in Attribut validation, sowie für Validierungs-Fehlermeldungen in Attribut message.

Beispiele:

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

</tml:form>


Diverse Anwendungsfälle verschiedener Input-Tags innerhalb einer Form:

<tml:form id="Test">
File Upload<br>
<tml:input type="file" name="FileUpload"> size="80" </tml:input><br>
Textfeld:<br>
<tml:input type="text" name="TextFeld"/> <br>
CheckBox:<br>
<tml:input type="checkbox" multiple="true" name="CheckBox" options="test01|1, test02|2, test03|3,test04|4,test05|5"/>
<br>
Boolean:<br>
<tml:input type="boolean" name="Auswahl"/> <br>
Textarea:<br>
<tml:input type="textarea" name="myTextArea"/> <br>
</tml:form>


<< innerlayout changeaction >>