Properties
The Input Widget properties panel is divided into shared properties (available in all modes) and mode-specific properties (available only when the relevant mode is active).
Shared Properties
These properties are available in all input modes.
| Property | Description |
|---|---|
| Name | Internal field name. Used for data binding and referencing the field in logic or scripts. |
| Label | The visible label displayed above or beside the input field. |
| Placeholder | Hint text displayed inside the field when it is empty. Not available in Date, Time, and Date & Time modes. |
| Required | Marks the field as mandatory. Validation fails if the field is empty when the form is submitted. |
| Required Message | The validation error message shown when the field is required but empty. |
| Readonly | Makes the field non-editable. The value is visible but cannot be changed by the user. |
| Force Readonly | Forces the field to be read-only when an existing record is being edited, regardless of the overall form state. Useful for fields such as record IDs or creation timestamps that must not be changed after initial entry. |
| Ignore Readonly | Overrides the Readonly setting. Allows the field to remain editable even if the form or parent container is set to read-only. |
| Visible | Controls whether the field is displayed. When unchecked, the field is hidden but remains configured. |
| Size | Sets the visual size of the input field: Small, Medium, or Large. |
| Variant | Sets the visual style of the input field: Outlined (border around the field), Filled (shaded background), or Standard (bottom border only). |
| Max Length | Maximum number of characters the user can enter. |
| On Change Handler | When enabled, the widget fires an onChange event to the backend each time the value changes. See Input Events. |
| Font Size | Overrides the font size defined in the project theme. |
| Font Weight | Overrides the font weight defined in the project theme. |
Text Mode Properties
These properties are available when the mode is set to Text.
| Property | Description |
|---|---|
| Validation | Applies a predefined regex pattern to validate the input. Select from common patterns (email, URL, numeric, etc.) or choose Custom to enter your own. |
| Custom Pattern | Visible when Validation is set to Custom. Accepts a regex string used to validate the field value. |
| Default Value | Sets an initial value when the form is loaded. |
| Uppercase | Forces all entered text to uppercase automatically. |
Text with Copy Mode Properties
Text with Copy mode shares all properties with Text mode. There are no additional configuration options — the copy button is always visible and requires no extra setup.
Date Mode Properties
These properties are available when the mode is set to Date.
| Property | Description |
|---|---|
| Date Format | Defines how the date is displayed in the input field (e.g., DD/MM/YYYY, MM-DD-YYYY). The stored value is always an ISO 8601 UTC string regardless of the display format. |
| Default Value | Sets an initial date when the form is loaded. |
| Show Icon | Displays a calendar icon inside the input field. |
Time Mode Properties
These properties are available when the mode is set to Time.
| Property | Description |
|---|---|
| Time Format | Defines how the time is displayed in the input field (e.g., HH:mm, hh:mm A). The stored value is always an ISO 8601 UTC string. |
| Default Value | Sets an initial time when the form is loaded. Options: empty (no default), Now (current time), or Start of Day (midnight UTC). |
Date & Time Mode Properties
These properties are available when the mode is set to Date & Time.
| Property | Description |
|---|---|
| Date & Time Format | Defines how the combined date and time value is displayed in the input field. The stored value is always an ISO 8601 UTC string. |
| Default Value | Sets an initial date and time when the form is loaded. |
Phone Mode Properties
These properties are available when the mode is set to Phone.
| Property | Description |
|---|---|
| Phone Format | Defines the input mask applied to the field. Use # for digits and _ as visual placeholders (e.g., (___) ____-____, +### ####-####). |
| Custom Pattern | A regex string used to validate the phone number after entry. |
| Uppercase | Forces all entered characters to uppercase automatically. |
Currency Mode Properties
These properties are available when the mode is set to Currency.
Currency Formatting
| Property | Description |
|---|---|
| Currency Format | Controls how currency symbols or codes are applied. None — no currency symbol is shown. Locale — uses the browser locale to determine the currency. Fixed Locale — uses the locale specified in Fixed Locale. |
| Fixed Locale | Visible when Currency Format is set to Fixed Locale. Specifies the locale string used for currency formatting (e.g., en-US, de-DE, fr-FR). |
| Currency | An explicit currency code (e.g., USD, EUR, JPY) that overrides locale-based detection. |
| Currency Display | Controls how the currency is shown: Symbol displays the currency symbol (e.g., $, €); Code displays the ISO currency code (e.g., USD, EUR). |
| Show as Symbol | When enabled, displays the currency symbol instead of the code. |
| Currency Field Name | The name of another form field whose value provides the currency code dynamically. When set, the currency code from that field overrides the Currency Format setting. |
Currency Field Name Example
If the form contains a Select field named currencySelector with values such as EUR, USD, or JPY, setting Currency Field Name to currencySelector causes the currency input to adopt the selected currency automatically.
Currency Field Name: "currencySelector"
→ currencySelector current value: "EUR"
→ Currency input formats values as: €1.234,56
Password Mode Properties
Password mode shares the same base properties as Text mode. There are no additional configuration options. The visibility toggle button is always rendered and requires no extra setup.