Skip to content

Dropdown#

The Dropdown widget can be used to collect user input from a list of options.

Insight² - Widget Reference - Dropdown

:::tip Dropdown options can be referred to your query data with dynamic variables. :::

Insight² - Widget Reference - Dropdown

Events#

Insight² - Widget Reference - Dropdown

Event: On select#

On select event is triggered when an option is selected.

Event: On search text changed#

This event is triggered whenever the user searches through the options by typing on the dropdown's input box. The corresponding search text will be exposed as searchText.

Properties#

Insight² - Widget Reference - Dropdown

Label#

The text is to be used as the label of the dropdown.

Default value#

Value of the default option

Option value#

Option values are values for different options in the list of the dropdown. Refer your query data with dynamic variables {{queries.datasource.data.map(item => item.value)}} or populate it with sample values {{[1,2,3]}}

### Option labels

Option labels are labels for different options in the list of the dropdown. Refer your query data with dynamic variables {{queries.datasource.data.map(item => item.label)}} or populate it with sample values {{["one", "two", "three"]}}

Options loading state#

Show a loading state in the widget using this property. It is off by default, toggle on to enable it. You can also programmatically set the values {{true}} or {{false}} by clicking on the Fx button.

Validation#

Custom validation#

Add a validation for the options in dropdown widget using the ternary operator.

Layout#

Show on desktop#

Toggle on or off to display the widget in desktop view. You can programmatically determing the value by clicking on Fx to set the value {{true}} or {{false}}.

Show on mobile#

Toggle on or off to display the widget in mobile view. You can programmatically determing the value by clicking on Fx to set the value {{true}} or {{false}}.

Styles#

Insight² - Widget Reference - Dropdown

Border Radius#

Use this property to modify the border radius of the dropdown. The field expects only numerical value from 1 to 100, default is 0.

Visibility#

This is to control the visibility of the widget. If {{false}} the widget will not visible after the app is deployed. It can only have boolean values i.e. either {{true}} or {{false}}. By default, it's set to {{true}}.

Selected text color#

Change the text color of the selected option in the widget by providing the HEX color code or choosing the the color from color picker.

Disable#

This property only accepts boolean values. If set to {{true}}, the widget will be locked and becomes non-functional. By default, its value is set to {{false}}.

:::info Any property having Fx button next to its field can be programmatically configured. :::