Number Input
The Number Input component allows users to enter numeric values. It can be used as a standalone component or in form fields. In this document, we'll go through all the configuration options for the Number Input component.
Properties
Property | Description | Expected Value |
---|---|---|
Label | Text to display as the label for the field. | String (e.g., Age ). |
Placeholder | A hint displayed to guide the user on what to enter. | String (e.g., John Doe ). |
Default value | The default value that the component will hold when the app is loaded. | String (e.g., Default Text ). |
Decimal places | Specifies the number of decimal places for numerical values. | Integer (e.g., 2 ). |
Events
Event | Description |
---|---|
On change | Triggers whenever the user types something in the input field. |
On focus | Triggers whenever the user clicks inside the input field. |
On blur | Triggers whenever the user clicks outside the input field. |
On enter pressed | Triggers whenever the user presses the enter button on the keyboard after entering some text in the input field. |
Check Action Reference docs to get detailed information about all the Actions.
Component Specific Actions (CSA)
Following actions of component can be controlled using the component specific actions(CSA):
Action | Description | How To Access |
---|---|---|
setText() | Sets the value of the input field. | Employ a RunJS query (for e.g., await components.numberinput1.setText(1) ) or trigger it using an event. |
clear() | Clears the entered text in the input field. | Employ a RunJS query (for e.g., await components.numberinput1.clear() ) or trigger it using an event. |
setFocus() | Sets the focus of the cursor on the input field. | Employ a RunJS query (for e.g., await components.numberinput1.setFocus() ) or trigger it using an event. |
setBlur() | Removes the focus of the cursor from the input field. | Employ a RunJS query (for e.g., await components.numberinput1.setBlur() ) or trigger it using an event. |
setVisibility() | Sets the visibility of the component. | Employ a RunJS query (for e.g., await components.numberinput1.setVisibility(false) ) or trigger it using an event. |
setLoading() | Sets the loading state of the component. | Employ a RunJS query (for e.g., await components.numberinput1.setLoading(true) ) or trigger it using an event. |
setDisable() | Disables the component. | Employ a RunJS query (for e.g., await components.numberinput1.setDisable(true) ) or trigger it using an event. |
Check the component specific actions available for this component here.
Exposed Variables
Variable | Description | How To Access |
---|---|---|
value | Holds the value entered by the user in the component. | Accessible dynamically with JS (for e.g., {{components.numberinput1.value}} ). |
label | Holds the value of the component's label. | Accessible dynamically with JS (for e.g., {{components.numberinput1.label}} ). |
isValid | Indicates if the input meets validation criteria. | Accessible dynamically with JS (for e.g., {{components.numberinput1.isValid}} ). |
isMandatory | Indicates if the field is required. | Accessible dynamically with JS (for e.g., {{components.numberinput1.isMandatory}} ). |
isLoading | Indicates if the component is loading. | Accessible dynamically with JS (for e.g., {{components.numberinput1.isLoading}} ). |
isVisible | Indicates if the component is visible. | Accessible dynamically with JS (for e.g., {{components.numberinput1.isVisible}} ). |
isDisabled | Indicates if the component is disabled. | Accessible dynamically with JS (for e.g., {{components.numberinput1.isDisabled}} ). |
Validation
Validation Option | Description | Expected Value |
---|---|---|
Make this field mandatory | Displays a 'Field cannot be empty' message if no value is entered. | Enable/disable the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |
Regex | Regular Expression to validate the input. | Regular Expression Pattern (e.g., ^\d{10}$ ). |
Min value | Sets the minimum value allowed. | Integer (e.g., 10 for a minimum value of 10). |
Max value | Sets the maximum value allowed. | Integer (e.g., 1000 for a maximum value of 1000). |
Custom validation | Specifies a validation error message for specific conditions. | Logical Expression (e.g., {{components.numberinput1.value<5&&"Value needs to be more than 5"}} ). |
To add regex inside Custom Validation
, you can use the below format:
Format: {{(<regexPattern>.test(<value>)) ? '' : 'Error message';}}
Example: {{(/^\d{1,10}$/.test(components.numberinput1.value)) ? '' : 'Error message';}}
Additional Actions
Action | Description | Configuration Options |
---|---|---|
Loading state | Enables a loading spinner, often used with isLoading to indicate progress. Toggle or set dynamically. | Enable/disable the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |
Visibility | Controls component visibility. Toggle or set dynamically. | Enable/disable the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |
Disable | Enables or disables the component. Toggle or set dynamically. | Enable/disable the toggle button or dynamically configure the value by clicking on fx and entering a logical expression. |
Tooltip | Provides additional information on hover. Set a string value for display. | String (e.g., Enter your age here. ). |
Devices
Show on desktop
Makes the component visible in desktop view. You can set it with the toggle button or dynamically configure the value by clicking on fx
and entering a logical expression.
Show on mobile
Makes the component visible in mobile view. You can set it with the toggle button or dynamically configure the value by clicking on fx
and entering a logical expression.
Styles
Label
Label Property | Description | Configuration Options |
---|---|---|
Text | Sets the color of the component's label. | Select the color or click on fx and input code that programmatically returns a Hex color code. |
Alignment | Sets the position of the label and input field. | Click on the toggle options or click on fx to input code that programmatically returns an alignment value - side or top . |
Width | Sets the width of the input field. | Keep the Auto width option for standard width or deselect it to modify the width using the slider or through code entry in fx that returns a numeric value. |
Field
Field Property | Description | Configuration Options |
---|---|---|
Background | Sets the background color of the component. | Select the color or click on fx and input code that programmatically returns a Hex color code. |
Border | Sets the border color of the component. | Select the color or click on fx and input code that programmatically returns a Hex color code. |
Text | Sets the color of the number entered in the component. | Select the color or click on fx and input code that programmatically returns a Hex color code. |
Error text | Sets the text color of validation message that displays. | Select the color or click on fx and input code that programmatically returns a Hex color code. |
Icon | Allows you to select an icon for the component. | Enable the icon visibility, select icon and icon color. Alternatively, you can programmatically set it using fx . |
Border radius | Modifies the border radius of the component. | Enter a number or click on fx and enter a code that programmatically returns a numeric value. |
Box shadow | Sets the box shadow properties of the component. | Select the box shadow color and adjust the related properties or programmatically set it using fx . |
Container
Padding
Allows you to maintain a standard padding by enabling the Default
option.