# Interface DashboardWidgetProps

Props for the DashboardWidget component

# Properties

# Data

# filters

filters?: Filter[]

Filters that will slice query results

Provided filters will be merged with the existing filters from the widget configuration.

# Overrides

Omit.filters


# filtersMergeStrategy

filtersMergeStrategy?: "widgetFirst" | "codeFirst" | "codeOnly"

Strategy for merging the existing widget filters (including highlights) with the filters provided via the filters and highlights props:

  • widgetFirst - prioritizes the widget filters over the provided filters in case of filter conflicts by certain attributes.
  • codeFirst - prioritizes the provided filters over the widget filters in case of filter conflicts by certain attributes.
  • codeOnly - applies only the provided filters and completely ignores the widget filters.

If not specified, the default strategy is codeFirst.


# highlights

highlights?: Filter[]

Highlight filters that will highlight results that pass filter criteria

# Overrides

Omit.highlights


# includeDashboardFilters

includeDashboardFilters?: boolean

Boolean flag whether to include dashboard filters in the widget's filters and highlights

If not specified, the default value is false.

# Widget

# dashboardOid

dashboardOid: string

Identifier of the dashboard that contains the widget


# description

description?: string

Description of the widget

If not specified, it takes the existing value from the widget configuration.

# Overrides

Omit.description


# highlightSelectionDisabled

highlightSelectionDisabled?: boolean

Boolean flag whether selecting data points triggers highlight filter of the selected data

Recommended to turn on when the Chart Widget component is enhanced with data drilldown by the Drilldown Widget component

If not specified, the default value is false


# styleOptions

styleOptions?: DashboardWidgetStyleOptions

Style options for the widget including the widget container and the chart or table inside.


# title

title?: string

Title of the widget

If not specified, it takes the existing value from the widget configuration.

# Overrides

Omit.title


# widgetOid

widgetOid: string

Identifier of the widget

# Callbacks

# onBeforeRender

onBeforeRender?: BeforeRenderHandler

A callback that allows you to customize the underlying chart element before it is rendered. Use the highchartsOptions object that is passed to the callback to change options values (opens new window) and then return the modified options object. The returned options are then used when rendering the chart.

This callback is not supported for Indicator Chart, Areamap Chart, and Scattermap Chart.

For an example of how the onBeforeRender callback can be used, see the Compose SDK Charts Guide.


# onDataPointClick

onDataPointClick?: ScattermapDataPointEventHandler | AreamapDataPointEventHandler | DataPointEventHandler | ScatterDataPointEventHandler | BoxplotDataPointEventHandler

Click handler callback for a data point


# onDataPointContextMenu

onDataPointContextMenu?: DataPointEventHandler | ScatterDataPointEventHandler | BoxplotDataPointEventHandler

Context menu handler callback for a data point


# onDataPointsSelected

onDataPointsSelected?: DataPointsEventHandler | ScatterDataPointsEventHandler

Handler callback for selection of multiple data points