Segmented Control
It is a set of choices or options arranged horizontally, and the user can pick one choice from the set. Recommended using the widget to show related multiple toggle options.
Basic
Manual
The list of options for the toggle set. The set can contain a single option, and more options can be added.
Property | Description |
---|---|
Label | The text to be displayed to represent the choice |
Value | The string value to refer the option element. It is used during development typically. |
Prefix Icon | Pick an icon by choosing one from the list of icons |
Disabled | Disables the user interaction with the option on the page. It visually indicates that the element is inactive and prevents users from interacting with it when applied |
Hide | This sets whether this option has to be displayed on the screen when the program is loaded. This shows/hides the option both on desktop and mobile devices. |
Map
Provide the JSON data of the array, consisting of the checkbox options in the key-value pair format.
Below is a sample JSON content - it must be placed in the 'Data' field of the Map section.
Property | Description |
---|---|
Label | The user must fill in the Label field with the code mentioned to get the data displayed. |
Value | The value field may refer the same Label string or user can mention a value in the JSON array with "value" property. |
Prefix Icon | Pick an icon by choosing one from the list of icons. The value picked in this field will reflect in every node of the widget. |
Disabled | Disables the user interaction with the option on the page. The value set in this field will reflect in every node of the widget. |
Hide | This sets whether this option has to be displayed on the screen when the program is loaded. The value set in this field will reflect in every node of the widget. |
Default Value
Enter the default option to be toggled-on when the widget is loaded. This can also be retrieved from the backend using query or loaded using low-code
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.
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.
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.
Style
Property | Description |
---|---|
Label | Set the colour for the label text. Recommended to set in contrast with the background. |
Text | Set the colour of the text. Recommended to set in contrast with the background. |
Text Transform | This property specifies how to capitalize an element's text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized. MDN web docs |
Text Decoration | This property sets the appearance of decorative lines on text. Types are "underline", "overline", "line-though", "overline-underline". |
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. |
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. |
Indicator Background | The objective of this technique is to create a two-colour focus indicator (having indicator background colour along with background colour) that has sufficient contrast against any solid background colour. |
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. |
Validation Message | Set the colour of the validation text message. Recommended to set in contrast with the background, usually Red. |
Last updated