All View Components → textinput

Select a view component to see details on how it works:

textinput

An input component that simply allows the user to enter text.

Example

Code in View XML:

<textinput label="First Name" bind="person.first_name" required="false" />
<textinput label="Surname" bind="person.surname" required="false" />

Appearance on a mobile device:

Configuration:

Option	Required?	Details
`bind`	required	Variable/attribute in which to store the text that the user entered. Must be a variable or attribute of type `string`, `int` or `decimal` (see Attribute & Variable Types for more details)
`label`	optional	Text to display above and inside the text input. It can be a Format String to make the text dynamic.
`required`	optional	`true` if this field must have a value before the user is allowed to proceed to another view. Defaults to `false`.
`show-if`	optional	Controls whether the component is hidden or shown. The argument specified to `show-if` can either be a literal boolean value (`true` or `false`), or it can specify a variable, parameter or attribute that can be a string, number, object, etc. that evaluates to false or evaluates to true (see the section Show/Hide Components Dynamically for full details). If the component also specifies `required="true"`, but it is hidden, the validation will be ignored/skipped.
`hide-if`	optional	The opposite of `show-if` (see above).

Keyboard Types

If the bind="" option for a textinput refers to an int or decimal attribute or variable, a numerical keyboard will be provided.

When bind="" refers to an attribute or variable of type string, it is also possible to use different keyboard types using String Specs (configured on the attribute or variable)