The select box widget lets the dashboard reader make a selection from a drop-down list. The choices in the drop-down can be text, numbers or dates. The select box can be used as a filter for other widgets, similar to the date picker.
Use the sidebar to configure the select box widget
Select the select box widget to display the settings in the sidebar. These settings include:
Use the General properties of the sidebar to add descriptive information for your select box widget. You can also:
- Choose whether the title of the widget should be displayed. If you enable this, then you can provide a title and icon for the widget and specify the font size, font color and text alignment.
- Choose whether a subtitle for the widget should be displayed. If you enable this, then you can add a subtitle for the widget and specify the font size, font color and text alignment.
- Specify the widget width within the section where it appears.
- Choose the background and border color for the widget.
Here you can add static informational content which will appear below the title of the widget. This can include text, images, tables, links and other common content tools.
The options available in a select box are typically populated from a field in a data source (or you can add them yourself as custom options). Often, you might populate the select box widget with a text string such as the About field of an event form, allowing the user to pick a single athlete and then view data about that athlete in the other widgets. Alternatively, you can use text strings, numbers or dates from any other field in the event form you’re using as your data source. Make sure you specify the correct options data type based on the data you’re displaying.
Use the data filters button to add filters which limit what values are available in your select box, based on other filter widgets (select boxes and date pickers) in your dashboard or custom filters applied directly to the select box.
You can also specify how you’d like the select box to order the available options. You can elect to order options by:
Value: will order based on the alphanumeric value of the option (regardless of whether the options are strings, numbers or dates).
Date of first occurrence: will order based on the first occurrence of each option. This will identify the date of the oldest record where each option occurred, and assign the order based on these dates.
Date of last occurrence: will order based on the last occurrence of each option. This will identify the date of the newest record where each option occurred, and assign the order based on these dates.
Based on the order of the options you select, you can also change the order direction to be ascending or descending.
In addition to this, you can choose whether or not you’d like the select box to reset options on data change. This will only have an impact if your select box has any filtering (from other select box or date picker widgets, or as custom filters). If this setting is turned on, your select box will reset to the first option in the list if the data changes, even if the previously selected option is still available based on any filtering applied.
This section gives you access to several settings which allow you to enable multiple selections in the widget, allow for an empty selection, and set a default selection.
In the Advanced properties section, you can choose whether to enable search. This allows the user to type in the select box field to find the option they’re looking for.