Text Input
A versatile text input field component that allows users to enter and edit single-line text content. It supports various input types (text, password, email), offers extensive validation options including length restrictions and pattern matching, can be styled using CSS classes, and includes multilingual support for labels and messages. The component's width can be customized, and it can be enabled or disabled, or made visible or invisible as needed. Perfect for forms requiring text data entry with validation.
Extends: fieldComponent
Fields
Name | Code | Data Type | Description |
|---|---|---|---|
Label |
| multi-locale | The visible text label that appears above the input field (Multi-lingual) |
Resource ID |
| text | A unique identifier for the field |
Style Classes |
| text | CSS class names to apply custom styling |
Width Class |
| text | Controls width using predefined width classes |
Value |
| text | The current text content entered in the input field |
Visibility |
| boolean | Controls whether the field is visible |
Enabled |
| boolean | Determines if the field is interactive |
Field Style |
| text | Custom inline CSS styles for the field |
Field Type |
| text | Type of text input (text, password, email, etc.) |
Placeholder |
| multi-locale | Example or hint text shown in the field (Multi-lingual) |
Validation |
| text | Rules for input validation (for example, length, pattern) |
Minimum Length |
| number | Minimum number of characters required |
Maximum Length |
| number | Maximum number of characters allowed |
Minimum Value |
| text | Minimum acceptable value for numeric input |
Maximum Value |
| text | Maximum acceptable value for numeric input |
Validation Pattern |
| text | Regex pattern the input must match |
Pattern Validation Message |
| multi-locale | Message shown when pattern validation fails (Multi-lingual) |
Custom Validation Script |
| text | Custom JS function for additional validation |
Custom Validation Message |
| multi-locale | Message shown on custom validation failure (Multi-lingual) |
Unique |
| boolean | Ensures value uniqueness |
Methods
Name | Description |
|---|---|
| Converts input value, decoding HTML entities for display |
| Converts input value, encoding HTML characters for storage |
| Determines input type based on configuration, with special handling for password visibility |
Events
Name | Description |
|---|---|
| Triggered when the user modifies the input text |
| Triggered when the input field loses focus |
| Triggered when the input field gains focus |