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 a header or side panel 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, how it's displayed, and the data or values on which it's based. On the Actions tab, you can specify the actions to be triggered by the selector.

Note:

The amount of vertical space selectors occupy in 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 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 the Configure element button Configure element. You can also change the order in which selectors appear in the panel by clicking the Move down button Move down or the Move up button Move up.

The category, number, and date selector properties are described below.

Category selector

The categories in a category selector can be based on a list of static values, features, or summary statistics that are calculated at run time. Category selectors with categories derived from features can be used to apply a spatial filter.

The available display types for this selector are drop-down, button bar, radio buttons, and check boxes. Radio buttons are available when the selector is configured for single selection and checkboxes are available for multiple selection.

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

If the number of values included in the selector exceeds the value of the Display type threshold setting, the display type default is drop-down to save space in the panel.

Category selector display types

If your selector is based on Grouped values, the categories are automatically generated based on the field names in your data. You can change the display label for a category by clicking +Override, entering the category you want to change, and clicking Add. When your category is added, you can change its label.

To change the label for most of or all your categories, click Load categories to add all the categories at once and edit their labels.

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 drop-down and slider. For the drop-down display type, depending on if your selector is based on a single value or numeric range, one or two input boxes will open. You can choose to specify the increments for the input boxes and specify a placeholder text that appears in the drop-down box. For the slider display type, you need to define the selector's upper and lower limits, which can be based on either defined values or statistics. You can choose to specify a precision for the slider.

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 drop-down, a button bar, or radio buttons. When you enable the None option toggle, None appears as a category in the selector, allowing 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