Selectors

A selector describes any dashboard element that supports a selection change event. Since they support events, selectors can trigger actions. The list element and operational layers on a map can be considered 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 side panel. You add a selector 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. On 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 on which it's based. The Actions tab is where you specify the actions you want 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 side panel or choosing a different selector configuration.

After a selector has been added to a panel, you can change its settings by hovering over it and clicking Configure element Configure element. 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.

Category selector

A category selector's categories can be based on a list of static values, features, or summary statistics that are calculated at run time. 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, radio buttons, and checkboxes. If the number of values included in the selector exceeds the value for the Display Type Threshold setting, the display type will be dropdown to save space in the panel.

Category selector display types

You can also specify whether users can select a single category or multiple categories simultaneously by adjusting the Selection setting. Optionally, you can choose to enable theNone Option setting, which causes None to appear as a category in the selector, allowing you to have nothing selected.

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 type, you need to define the selector's upper and lower limits, which can be based on either 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 predefined 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 radio buttons, the same options as the category selector. Also like the category selector, when the None Option setting is enabled, None appears 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 displays 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 displays both predefined options and a date picker, the same settings are available for each type as when the selector only contains one type. The only additional setting is Label for Manual, which controls how the date picker is referenced in the display of the defined options.

Date selector display types