Skip To Content

Configure a list widget

The list widget shows a sorted collection of features or rows. The list can include all of the features from the data source or can be limited to display only a certain number of features. For example, a list widget can be configured to detail all the buses in a municipal transportation district and sort them by their remaining fuel, with those that have the least amount of fuel at the top of the list.

The listed features sort themselves based on updated information. In an emergency management scenario, the list could be configured to show the currently open evacuation shelters and their remaining capacities. In addition, the list widget can display items based on a selection. If the selection changes, the list re-sorts itself. Features may also appear and disappear from the list when only a subset of features from the data source is included.

When configuring how the feature is displayed, you can include an icon to represent the feature in the list, such as whether an evacuation center is a medical facility or a school. You can also include additional information for each item in the list, which can be static or can be obtained from field values. In the following example, Capacity displays before the field values:

List widget showing open shelters

Feature actions add display and navigation functions to individual features in the widget. If the widget's data source is a layer in a map, you can zoom the map to the feature, flash it on the map, select it on the map, or have the map follow the feature as it moves automatically.

The list widget can be the data source for another widget. When configuring other widgets, you can set either the top item or the selected item in the list to be the data source. For example, using the information in the list, you can configure a gauge to sum the evacuees from all the shelters to monitor when the city's evacuation center capacity has been exceeded.

  1. Click Edit, and click Edit Operation View.
  2. To create a new widget, click Widget, click Add Widget, choose the type of widget, and click OK. To update settings for an existing widget, click Settings Settings, and click Configure Configure on the widget's window.
  3. Click the Data Source drop-down arrow, and choose the item that will provide the data for the widget.
  4. To display the features in a selection if one is made, and to show the full list of features from the data source when no selection is made, click Display map selection if available. This ensures the list is never empty and also that the list and other widgets using the list as their data source reflect a selection on the map when one exists.

    This option is only available for selectable data sources.

    If you want your list to display only features selected in the map, and the list to appear empty when no selection is made, set Data Source to the selection of the layer instead of using the Display map selection if available option.

  5. In the Title box, type a title that will be displayed in the widget's window.
  6. In the Description box, type a caption that will be displayed below the widget.
  7. To show a search box in the list widget, click Allow Search. This allows users of your operation view to reduce the data shown in the list based on a search criteria.
  8. Set the field to sort the data in the list, the order in which the values should be sorted, and the maximum number of items that should be shown in the list.

    The Max count option is not available if using a selection data source. If Display map selection if available is enabled, the max count setting is ignored when a selection exists on the map.

  9. Click the Selection Mode drop-down arrow and choose how items can be selected in the list. Single means that only one feature at a time can be selected, and multiple mode allows more than one item to be selected in the list.
  10. When configuring other widgets, you can drive their content by the selected item in the list. Click Select the top item by default to keep the top item in the list selected as the list's contents change. With this option, users can select other items in the list, and the widgets that work with the list's selection will update.

    Do not select this option if you want other widgets to always work with the top item in the list, independent of the user's selection. For other widgets to always honor the top item in the list, set the data source of the other widgets to the list's top. If you enabled Select the top item by default, the list will not expose its top item as a data source.

  11. Click the Feature Display tab to set how each feature should be depicted in the list.
  12. In the Title box, type a title for the feature. This can be a combination of static text and values from one or more fields. Click the Insert Field button to insert a field into the title.
  13. Set the type of icon to be displayed next to the feature in the list. Click None if you do not want any icons to display, Symbol to use the feature's symbology in the list, or URL to pull the symbol from a website. This URL can be constructed from a combination of static text and field values.
  14. To include additional information about the feature, add a description. Click Single Field and choose one field to use. To build a custom description that contains rich text, which could include a combination of text and field values, click Custom. Click the Insert Field button to add a field, type any leading or trailing text, and set the text formatting as desired.
  15. Click the Feature Actions tab to set which tools are available when interacting with features in this widget.
  16. Set which action occurs when double-tapping or double-clicking within the widget.
  17. When you're satisfied with the preview, click OK to finish configuring the widget.