List Box
The List Box allows users to select one or more values from a displayed list to filter and interact with dashboard data.
Configuring Data
Configure the data for the List Box in the ASSIGN DATA tab.
| Data section | Requirement | Description |
|---|---|---|
| Value | Required | Specifies the measure or dimension field whose values are used by the List Box. |
| Display Column | Optional | Specifies the field whose values are displayed in the List Box. |
| Filters | Optional | Allows you to apply additional filtering conditions to the List Box data. |
Assigning Data
- Drag and drop the List Box widget from the toolbox onto the design canvas.
- Resize the widget as required.
- Select the List Box widget and click the Settings icon to open the configuration panel.
- Switch to the
ASSIGN DATAtab. - Drag and drop a measure or dimension field into the
Valuesection. - Optionally, drag and drop a field into the
Display Columnsection. - Optionally, add fields to the
Filterssection to apply additional filtering conditions.
Field Settings
Click the More options icon for a field to configure the following options.
- Sort – Sorts the values in ascending or descending order. See Advanced Sorting.
- Filter(s) – Applies filter conditions to include or exclude specific values. See Configuring Widget Filters.
- Relative Dates – Configures relative date ranges when a date dimension is used. See Relative Date Filter.
Formatting the List Box
You can format the List Box using the settings and property categories listed below.
Basic Settings
Configure the basic behavior and selection-related settings of the List Box.
Enable Multiselect
Allows users to select multiple values from the List Box. Disable this option to allow only a single selection.
Show All
Adds an All option at the top of the list to clear the selection filter.
Enable RTL
Displays the List Box content from right to left.
Font Settings
Refer to Font Settings for information about configuring font-related properties.
Filter
Refer to Filter Settings for information about configuring filter-related properties.
Container Appearance
Refer to Container Appearance for information about configuring the appearance of the widget container.
Container Actions
Refer to Container Actions for information about configuring the actions available for the widget container.
No Data Appearance
Refer to No Data Appearance for information about configuring how the widget is displayed when no data is available.