You can control the dashboard item caption's visibility.
When the caption is on, it is always displayed at the top of the dashboard item. Some command buttons are displayed when you hover the mouse pointer over them.
When the caption is off, it is not visible by default. Some command buttons are displayed in a floating panel when you hover the mouse pointer over them. On touch-based devices, you need to do extra click to show the caption elements when the caption is hidden.
Go to the dashboard item Options menu and use the Show Caption option to control the caption visibility:
Shows a value or values from the current drill-down hierarchy. See Drill-Down for more details.
Shows a static text in the caption. Use the DashboardItem.name property to set a caption text.
Expands any dashboard item into the whole dashboard size to examine data in greater detail. Refer to Dashboard Items Layout for more information.
Restores the expanded item to its initial state.
Export to button
Invokes the export menu for a dashboard item. To learn how to export individual dashboard items, see Exporting.
Inspect Data button
Invokes the Data Inspector that contains two grids that display raw and aggregated data for the current dashboard item.
Invokes a drop-down menu that allows you to switch between provided values (in the pie, card, gauge and maps dashboard items). To learn more, see the Providing Data topic for the corresponding dashboard item.
Allows you to filter data by selecting multiple elements in dashboard items.
Select Date Time Period menu / button
Allows you to select date-time periods for the RangeFilter and DateFilter items.
Displays filters affecting the current dashboard item or entire dashboard. This button is only available in mobile layout.
Clear Master Filter button
Allows you to reset filtering when a dashboard item acts as the Master Filter. To learn more, see Master Filtering.
Drill Up button
Allows you to return to the previous detail level when this item's drill-down capability is enabled.
Clear Selection button
Allows you to clear the selection inside an item.
Initial Extent button
Restores the default size and position of the Map dashboard items.
The Web Dashboard allows customizing the dashboard item's caption and dashboard title. For instance, you can add custom command buttons, create additional menus, add static texts, etc. Use the DashboardItemCaptionToolbarOptions class to get access to a specific toolbar item's collection in the dashboard item caption (like command buttons or static text). The ViewerToolbarItem object represents a toolbar item.
Use the following members to customize the dashboard item's caption:
Specifies a handler for the event occurring before the dashboard item caption toolbar is updated.
You can use predefined colors for toolbar icons to make the icons consistent with the entire dashboard application. For example, you can use the predefined color for a new toolbar button. In this case, the button's color depends on the selected Web Dashboard theme.
The table below lists the available predefined color classes:
The theme's primary color.
The theme's additional color.
The theme's accent color.
A green hue based on the theme.
A red hue based on the theme.
A yellow hue based on the theme.
Use the class="colorName" attribute in the icon's svg definition to specify the icon's color. If you want to change an icon's color when it is hovered, add the style="fill: currentColor" attribute to the svg definition.
The code snippet below defines an icon that changes its color depending on the theme's primary color and when you hover over it:
The following example shows how to add a toolbar item to the dashboard item caption. The code snippet below creates a custom button with a popup menu for the Chart dashboard item. The ItemCaptionToolbarUpdated event is used to customize the dashboard item caption. The button belongs to the actionItems collection and is displayed only when the mouse pointer hovers over the dashboard item caption. The popup menu contains three icon elements.