InputGrid Block Documentation

The InputGrid is a powerful, flexible input component designed for structured and secure text entry—ideal for PINs, OTPs, verification codes, or other multi-part inputs. It supports full customization of behavior, appearance, input restrictions, and seamless user experience across devices.

🔧 Parameters

Name	Type	Description
NumberOfControls	Integer	Number of separate input fields to generate.
CharsPerControl	Integer	Number of characters allowed per individual input field.
Value	Text	Holds the full concatenated string value from all inputs. Use this to set values programmatically.
ContainerStyleClass	Text	CSS class for styling the outer container.
InputStyleClass	Text	CSS class for styling each input field.
FilledStyleClass	Text	CSS class applied to inputs that contain values.
ErrorStyleClass	Text	CSS class applied to inputs with invalid or incomplete data.
IsMandatory	Boolean	Determines whether input is required.
IsSelectedOnFocus	Boolean	Automatically selects all text when input field is focused.
IsEnabled	Boolean	Enables or disables all input fields.
InputType	Text (Choices: Clear, Password) Default: Clear	Determines the input field type. Use `Password` to mask the input.
InputAllowed	Text (Choices: AnyInput, Digits, Letters, LettersAndDigits, Custom) Default: AnyInput	Restricts what type of input is accepted. Choose `Custom` to define a regular expression.
RegEx	Text	Used only when `InputAllowed = Custom`. Required to define the accepted input pattern.

⚡ Events

1. WidgetCreated (Optional)

Triggered when the widget is initialized—useful for saving the widget ID to trigger client actions like focus.

Outputs:

Id (Text): The unique ID of the InputGrid widget.

2. ValueChanged (Mandatory)

Triggered whenever an input value changes, providing live feedback and validation state.

Outputs:

Value (Text): The concatenated value from all input fields.
IsLast (Boolean): True if the last input field has been focused and received input.
IsValid (Boolean): True if the current input length equals NumberOfControls * CharsPerControl.

🧠 Client Actions

StartFocus

Focuses the first input field of a specific InputGrid instance.

Inputs:

Id (Text): The widget ID returned by the WidgetCreated event.

📱 Mobile Support

- Fully optimized for mobile devices.

- Automatically triggers the numeric keyboard when