Multi Select
It allows the input of multiple selections of items from a defined set of items. It is achieved through a dropdown list and each item on the list shows a tick-mark when selecting the options.
Basic
Manual
The list of options for the select list. The set can contain a single option, and more options can be added.
Label
The text to be displayed to represent the select option
Value
The string value to refer the option element. It is used during development typically.
Prefix Icon
Choose one from the set of icons that will be displayed as a prefix logo, just before the button text.
Disabled
Disables the user interaction with the particular 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.
[
{
"count": "32",
"title": "Channel Uploads",
},
{
"count": "253",
"title": "Oldest",
},
{
"count": "25",
"title": "Newest",
},
{
"count": "10",
"title": "Top",
}
]
Label
The user must fill in the Label field with the code mentioned to get the data displayed. {{item.title}}
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 checked 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.
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
Change
The "Change" event is activated when the value of the widget is changed. When this event triggers, the associated action gets executed.
Focus
This event is triggered when the widget receives focus, meaning it becomes the active element that can accept user input.
Blur
This event occurs when the user shifts the focus out of the widget. This can happen in different scenarios, such as when a user clicks outside an input widget they were typing in or when the user tabs to another field.
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
Position
Left
Shows the label on the left side of the tree view
Top
Shows the label on top of the tree view
Alignment
Left
Align the text on the left corner of the label area
Right
Align the text on the right corner of the label area near the tree view
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
Show Clear Button
Displays a small 'x' type button at the end of the widget, which helps the user to clear out the previous entries and selections.
Searchable
Enables the search feature for users to type and search. It filters down the results and shows the matching options.
Enable Select All option
Provides users with the feature to select all the options at one click. It also allows to deselect all options at once.
Style
Label
Set the colour of the label text. Recommended to set in contrast with the background.
Text
Set the colour of the options' 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.
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.
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.
Tags
Set the colour for the chosen options and displayed as the selected items.
Tags Text
The colour for the 'x' mark on the chosen options.
Multiselect Icon
The colour for the tick-mark on the chosen options, shown when they are collapsed on user click on the widget.
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.
Dropdown Background
Set the background color for the dropdown area. 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.
Dropdown Hover Background
Set the background color for the dropdown area when the mouse-hover action occurs. 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.
Dropdown Selected Background
Set the background color for the selected options. 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.
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.
Custom CSS
Users can write a specific style using CSS syntax here and the style text will be applied to the widget when the program is loaded.
Last updated