Skip To Content

Selectors

A selector describes any dashboard element that supports a selection change event. Since they support events, selectors can trigger actions. The list element as well as operational layers on a map can be thought of as selectors because you can select rows on a list, and you can select features from the operational layers shown on a map. However, this topic focuses on the category, number, and date selectors.

These selectors can only be added to the header and left panel. A selector is added to one of these panels by hovering over it and clicking Add Category Selector Add category selector, Add Number Selector Add number selector, or Add Date Selector Add date selector.

You can configure selectors in various ways. In the Selector tab you can specify properties specific to the element, such as the selector's title and how it's displayed, as well as the data or values it's based on. The Actions tab is where you specify the actions that should be triggered by the selector.

Note:

The amount of vertical space selectors occupy on a panel can differ depending on how they are configured. Some selector configurations are not possible on the header because it has a fixed height. If you can't configure a selector a particular way on a dashboard's header, try adding the selector to the left panel, or choosing a different selector configuration.

After a selector has been added to a panel, you can edit its settings by hovering over it and clicking Configure Configure. You can also change the order in which selectors appear in the panel by clicking Move Down Move down or Move Up Move up.

The remainder of this topic discusses the properties specific to the category, number, and date selectors, respectively.

Category selector

A category selector can base its categories on a list of static values, features, or summary statistics that get calculated at runtime. When a category selector gets its categories from features, it can be used to apply a spatial filter.

The available preferred display types for this selector are dropdown, button bar, a list of radio buttons, and checkboxes. If the number of values included in the selector exceeds the value for the Display Type Threshold setting, then the display type will be dropdown, to save space in the panel.

You can also specify whether users can select a single category or multiple categories simultaneously by adjusting the Selection setting. If you choose Single for the Selection setting, the None Option setting appears. When enabled, this causes "None" to appear as a category in the selector, allowing you to have nothing selected.

Category selector display types

Number selector

A number selector can be based on a single fixed value or a numeric range. The available display types for this selector are input box, spinner, and slider. If you choose the input box display type, you can specify placeholder or hint text that appears in the boxes, such as Enter value. If you choose the spinner or slider display types, you need to define the selector's upper and lower limits, which can either be based on defined values or statistics. For the spinner and slider display types you can also set the increment by which values increase or decrease in the selector.

Number selector display types

Date selector

A date selector can be configured to show pre-defined date and time options, a date and time picker, or both. When the selector shows predefined dates and times, it can be displayed as a dropdown, button bar, or list of radio buttons, like the category selector. Also like the category selector, when the None Option setting is enabled, "None" shows as a category in the selector, enabling you to have nothing selected. You can also specify whether the first or last option is selected by default when you predefine the options.

When the selector shows the date and time picker, you can specify whether users can choose a single value from one picker or a range of values from two pickers. You can also control the default values for the date pickers.

When the date selector shows both predefined options and a date picker, the same settings are available for each type as when the selector only contains this type. The only additional setting is Label for Manual, which controls how the date picker is referred to in the display of the defined options.

Date selector display types