Number Input
This widget can be used when the user wants to capture number input, it allows only numerical strings. It can be used within a form or can be used as a standalone component.
Basic
Default Value
Enter the default string to be displayed when the widget is loaded. This can also be retrieved from the backend using query or loaded using low-code.
Placeholder
Specifies a hint that describes the expected value. The placeholder shows the hint text in the widget when nothing is selected or entered. This text disappears as soon as a value is entered in the control.
Format
Property | Description |
---|---|
Standard | |
Percent |
Validation
Required Field
Refers to the field that must be completed by the user, which means the field must be entered with a valid value before submitting the information.
Minimum
The number value entered here acts as the validation for the minimum number for the field. Users cannot enter any value below this.
Maximum
The number value entered here acts as the validation for the maximum number for the field. Users cannot enter any value higher.
Custom Rule
Apart from validating the entry using the regex rule, users can also use this property to write low-code and check other aspects. For example - check if the city selected in the previous field matches the desired value, throw a custom message to the user even before capturing the entry on this field.
Interaction
Event Handlers
Event | Description |
---|---|
| |
| |
| |
|
Disabled
Disables the user interaction with the element on the page. It visually indicates that the element is inactive and prevents users from interacting with it when applied. Shows a red-crossed warning symbol and can be customized to disable the widget according to certain conditions using low-code.
Hide
This sets whether the widget has to be displayed on the screen when the program is loaded. This shows/hides the widget both on desktop and mobile devices.
Loading
It will be useful when there is a process to be carried out, like running a query to fetch data, before the widget is loaded. The loading
boolean value can be utilized to show the spinner till the process is complete.
Label
Represents the caption for the widget in the user interface. It is recommended to keep the label string short and convey the usage of the widget in the UI
Tooltip
This tooltip pops up when the user moves the mouse over the label area of the widget. This is commonly used to provide some extra or important information to the user on the usage of the widget.
The tooltip will be immediately shown when the user's mouse hovers over the widget, and immediately hides when the user's mouse leaves. This information will be contextual, useful, and informative.
Position
Property | Description |
---|---|
| |
|
Alignment
Property | Description |
---|---|
| |
|
Width
Enter a number value to set the width of the widget. It can be set in terms of pixels and percentage.
Layout
Widget Tooltip
This tooltip pops up when the user moves the mouse over the input area of the widget. It is commonly used to hint at the type of input the user needs to provide.
The tooltip will be immediately shown when the user's mouse hovers over the widget, and immediately hides when the user's mouse leaves. This information will be contextual, useful, and informative.
Height
Auto | The height is auto-adjusted for the content |
Fixed | The height of the widget is fixed |
Advanced
Step
The value must be greater than 0. When the user clicks the up/down buttons at the end of the widget, this number will be increased/decreased to the current number.
Precision
This decides the floating-point precision for the number entered on the widget. If the user enters '2' in the property, then the decimal precision is set to 2 digits.
Prefix Icon
Choose one from the set of icons that will be displayed as a prefix logo, just before the button text.
Allow Null Value
This allows the NULL value to be accepted as a value. This is usually related to development requirements and not necessarily enabled for common use cases.
Show Thousands Separator
Enables the comma character separator to split and group the number for easy understanding.
Show Increment/Decrement Buttons
Displays the UP and Down arrow buttons on the right end of the widget, for users to click the button to increase and decrease the current input respectively.
Read Only
Disables the user entry on the widget, it will be set as read only component. Commonly used to show numbers fetched from backend but to deny user keyboard interaction.
Style
Property | Description |
---|---|
Label | Set the colour for the label text. Recommended to set in contrast with the background. |
Background | Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly. |
Text | Set the colour of the text. Recommended to set in contrast with the background. |
Loader Color | Pick the colour to the loading spinner when the component shows the loader before getting displayed. |
Text Size | Set the size of the text in px value - 12px |
Text Weight | Increase or decrease the thickness of the font using the list of numbers from 100-800. |
Font Family | Type the name of the font family. The reference to the list of font families can be found here: MDN web docs |
Font Style | There are 3 types of styles that can be applied: "normal" - The text is shown normally, no style applied. "italic" - The text is cursive. "oblique" - A sloped version of the normal text. |
Border Color | Set the colour to the border lines. The border lines will be shown only if that is enabled. |
Margin | This value is set in terms of "px" number which creates the space between the border and the content of the widget. |
Padding | This value is set in terms of "px" number which creates the space between the border and outer elements. |
Border Radius | This sets the radius of the widget's corners, enabling rounded corners on the widget. This value is defined in "px" terms. |
Border Width | Set the thickness of the border of the widget using this value. It is defined using "px" terms. |
Accent | An accent is a typically bright colour that contrasts with the more utilitarian background and foreground colours within a colour scheme. These are present in the visual style of many platforms (though not all). On the web, an accent is sometimes used in input elements for the active portion of the control, for instance, the background of a checked checkbox. MSDN web docs |
Validation Message | Set the colour of the validation text message. Recommended to set in contrast with the background, usually Red. |
Box Shadow | The is the colour of the shadow that is generated behind the widget box. The X and Y axis values can be altered such that the shadow can be set to fall anywhere behind the widget area. "x-offset" - a positive number specifies the shadow will be on the right of the box, and a negative number will put the shadow on the left of the box. "y-offset" - a negative one means the shadow will be above the box, and a positive number means the shadow will be below the box. "Blur" - if the number is set to 0 then the shadow will be sharp. It will more blurred as the number goes higher, and the shadow will extend further away. "Color" - sets the colour of the shadow. If the colour is not set, the box shadows are drawn in the foreground colour. |
Last updated