List

The List widget lists the values of one or two assigned data source columns.

You can use the List widget to select values, for example, to filter multiple values in other widgets.

In view mode, the widget provides check boxes for selection when multiple selection is enabled. You can select multiple values by pressing the Shift key and clicking several rows.

The following widget options are available.

General options

Description

Name

Optional component name.

More options

Displays additional options.

Container

Hide header: Hides the header as well as the title of the component, and resizes the content of the container. Click the icon again to display the header. The header is hidden by default.

Hide border: Hides the outline of the component container. Click the icon again to display the outline. The border is visible by default.

Container style

Selects the style type of the container. The container styles available in the drop-down menu are part of the style template selected for the current dashboard. The Default widget style is preselected.

Style

Selects the style type of the component. The component styles available in the drop-down menu are part of the style template selected for the current dashboard. The Default widget style is preselected.

Auto refresh

Sets the automatic data retrieval of the component.

Show menu

Enables the widget menu in view mode. In view mode, you can display the widget menu by clicking the Show menu Menu icon in the widget header. In the widget menu, you can, for example, clear a selection, refresh the data displayed, or save the component widget in a CSV file.

 

Specific list options

Description

Edit columns

Enables you to edit the List widget interactively. Click the Configuration icon. In edit mode, the List widget has a blue frame.

You can set the initial widths and the initial sort order of the columns. You can change the sort order by clicking the column header. To adapt the column width, drag the column borders using the mouse. You can change the defined column width and column sort order in dashboard view mode.

Multiple selection

In view mode, the user can select multiple values at the same time in the corresponding widget, for example, multiple rows in a table or multiple coordinates in a chart. The multiple selection can be used, for example, to filter other dashboard widgets. See Use interactive filters in dashboards for details. The values selected are processed as a list. If the option is enabled, columns of List type are provided in the filter configuration dialog to configure filter conditions. See Define filters for dashboard widgets for details.

The option is enabled by default.