List widget displays a list of items with one or many numeric properties. Numeric values are overlaid over the item names as colored bars, effectively creating a nice scrollable bar chart.
Array - an array of item IDs to be selected (highlighted) in the list.
Array - emits an array of IDs of the selected items.
List widget can be used to display a simple list of items or a numbered list of items with overlaid bars. Its useful for displaying top-n lists or leaderboards.
The widget title.
Bar color (positive)
The color of positive bars (use Hex code e.g.
Bar color (negative)
The color of negative bars (use Hex code e.g.
Max number of items per page
List widget will only load and render items up to this limit. If the number of items in the dataset is more than this limit the next page of items will be automatically loaded when user scrolls to the bottom of the list.
Specify the converter for numeric values. See Value Formatters to learn how to format values of different types.
If turned on, will allow user to select multiple items in the list. Use
Command + Click (Ctrl + Click on PC) to select multiple individual items, or
Shift + Click to select a range. By default multi-select is disabled.
At least one item in the list must be selected. When List widget is initialized the top most item in the list is automatically selected and emits an event on
Show numbered list
If turned on, will display the sequence number next to each item in the list.
Show absolute and % values
For each numeric value widget calculates relative % values. If this setting is turned on, both absolute and relative % value will be displayed.
Name column header
Set custom header for the name column. By default "Name" header is used.
Name field key
Key in the input dataset that will be used for items Name.
ID field key
Key in the input dataset that will be used for items ID.
By default widget will display all aggregations provided in the input data. Use + button to specify one or more aggregations that you want to display. All the remaining aggregations will be omitted.
Show in Datascope
If turned on, the widget will be added to Datascope panel.
Hide progress bar
Controls the visibility of widget progress bar (visible by default).
Hide help icon
Controls the visibility of help icon (visible by default).