OpenWGA 7.8 - WebTML reference

WebTML tags

<tml:input>

Description :
This tag defines input fields for WebTML forms.

It is the WebTML pendant to the HTML tags <input> and <select> offering various types of input fields and additional functions including validation and change-triggered WebTML actions.
Derived from: Only available in the following parent tags: Attributes:
show inherited attributes ...
Name Value(s) Purpose
changeaction action-id Specifies an action which is automatically called when the field value changes
cleariferror fieldname1,fieldname2,... Specifies names of other TML form fields which should be truncated when the validation of the current field fails.
cssclass css-class Specifies an css class for the input field
cssstyle css-style Specifies a css style definition for this input field. The value is unmodfied rendered as HTML attribute "style" of the input tag.
default string Specify a default value for the field
defaultexpression tmlscript-expression Determines a default value for the field using TMLScript
encodeoptions true | false Activates or deactivates the automatic option encoding.
focus true | false Sets the focus to this input field.
html_attribute html-value Defines a custom HTML attribute that will be added to the generated HTML input tag
labeled true | false | wrap Wraps the option titles of type="checkbox|radio" inside HTML label tags
message validation-message Defines the validation message for a specified validation expression.
meta true | false Specifies if the input field should be stored as meta or not. If meta is "true" the value given within the attribute "name" is interpreted as meta name.
mode edit | readonly | view Specifies the display mode of the <tml:input>.
multiple true | false Specifies if the input should allow multiple values
name item-name Specifies the name of the item or if meta="true" the meta field whose value will be modifed by the input.
options option1[|value1],option2[|value2], ... Specifies predefined options for the input field.
optionsitem item-name

This is an alternative way to specify options for this input. The attributes names an item or WebTML variable which contains a list defining the options to use.  Each list element defines one option. You may specify option values only or option title and option value divided by a pipe symbol "|".  If you do not specify titles you may also let them be calculated by attribute optionstitle.

If you want WebTML to automatically retrieve options for a HDBModel relation then you need to omit both attributes options and optionsitem.

optionstitle tmlscript-expression Calculates option titles for option values
relationtype normal | protected Lets <tml:input> store relations instead of items
sortoptions [value,]asc | desc Sorts the options of this input
store true | false Specifies if this input should be persistent or not. None persistent fields will not be stored in the document by the tmlform.storeIn..() methods.
type="boolean" boolean Creates an input field for a boolean value.
type="file" file Provides an upload dialog for a file attachment.
type="hashedpassword" Defines an input field for a password. Instead of the original value this field stores only the hashed value in the content document. The original value is not recoverable from these hash.
type="number | date" number|date Provides an input field for number or date values.
type="select | checkbox | radio" select Provides an input field for choosing predefined values
type="text | password | hidden" text|hidden|password Creates a standard HTML text input field. For type="password" the characters will be marked. For type="hidden" the whole field will not be visible in the ui.
type="textarea" textarea Provides a multi line text input field.
validation tmlscript-expression Specifies a validation expression which will be evaluated when the TML form is stored.
validationdivider divider Specifies a divider to separate multiple validation rules and their corresponding messages.

Details:
While it is theoretically possible to use plain HTML inputs inside WebTML forms you should prefer inputs rendered by this tag as it not only provides additional functionality but also security. WebTML forms for example monitor the WebTML inputs that were registered for them and will not accept additional inputs that are posted (unless it is explicitly allowed via the htmlinput attribute).

This tag is derived from <tml:[All action calling tags]> because it is able to call a WebTML action on data change when attribute changeaction is defined. It accepts all attributes from there except form which does make no sense here and param1...param5 because the parameters used on this action are predefined (see changeaction for details).
Examples:
A custom form demonstrating some field types.

<tml:form id="aForm">
    File upload<br>
    <tml:input type="file" name="aFileupload">size="80"</tml:input><br>

    Text:<br>
    <tml:input type="text" name="aTextField"/> <br>

    CheckBox:<br>
    <tml:input type="checkbox" multiple="true" name="aCheckBox" options="red|1, green|2, blue|3"/><br>

    Boolean:<br>
    <tml:input type="boolean" name="yesNo"/> <br>

    Textarea:<br>
    <tml:input type="textarea" name="aTextArea"/> <br>

</tml:form>