Skip to content

Text Box

TextBox is a single-line, XPath-bound input. It inherits Size, PlaceHolder, RequiredForGroup, rules, and hints from the shared text-control behavior.

XML Fields

Value and Input Type

  • XPath identifies the form-data field that the widget reads and updates.
  • Type selects Text, Password, EMail, Search, Url, or Tel. It changes the input affordance and the read-only presentation: passwords are masked; e-mail and URL values are presented as links.
  • MaxLength limits the entered character count. InputMask supplies an optional entry mask; it guides entry but does not replace a validation rule for the saved value.

Layout, Help, and Validation

  • Size controls the widget width within its container. PlaceHolder is text shown inside an empty editable field.
  • RequiredForGroup makes the field mandatory when a button validates that group. Hints supplies help text. Rules contains formatting rules and validation rules that can change the field state or reject an invalid value.

Input Types

Set Type to one of Text, Password, EMail, Search, Url, or Tel. The type selects the browser input type and its icon. In read-only state, Password is masked, while EMail and Url render as links. Password inputs use new-password autocomplete to avoid filling an existing credential.

Length and Mask

MaxLength limits input length and defaults to 255. InputMask is optional; when supplied, the client applies the configured masked-input pattern. A mask guides entry but does not replace server-side validation of the saved value.

Example

1
2
3
4
5
<TextBox XPath="Customer/Email" MaxLength="320" InputMask="" Type="EMail" Size="Large" RequiredForGroup="">
    <PlaceHolder><![CDATA[[email protected]]]></PlaceHolder>
    <Hints><![CDATA[]]></Hints>
    <Rules />
</TextBox>