Skip to main content

List widget

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.


select Array - an array of item IDs to be selected (highlighted) in the list.

data QData - queryable data port for passing input data. Compatible with List Adapter and Crossfilter Dimension components.


selection 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.

To prepare input data for List widget use List Adapter or Crossfilter Dimension components.



The widget title.

Bar color (positive)#

The color of positive bars (use Hex code e.g. #27AE60)

Bar color (negative)#

The color of negative bars (use Hex code e.g. #C0392B)

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.

Value converter#

Specify the converter for numeric values. See Value Formatters to learn how to format values of different types.

Enable multi-select#

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.

Require selection#

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 selection port.

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.

Select aggregations#

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).