Markers

CartesianMarkers highlight points on CartesianCharts. There are two types of CartesianMarker:

Compose

• Standard CartesianMarkers are shown when the CartesianChart is tapped. Add such CartesianMarkers via the marker parameter of CartesianChartHost.
• Persistent CartesianMarkers are shown permanently. Add them via the persistentMarkers parameter of rememberCartesianChart.

Views

• Standard CartesianMarkers are shown when the CartesianChart is tapped. Add such CartesianMarkers via CartesianChartView#marker.
• Persistent CartesianMarkers are shown permanently. Add them via CartesianChart#persistentMarkers.

CartesianMarkers use CartesianMarker.Targets, which hold information on the highlighted points. Each CartesianLayer has its own implementation, giving us CandlestickCartesianLayerMarkerTarget, ColumnCartesianLayerMarkerTarget, and LineCartesianLayerMarkerTarget.

There are two ways of creating a CartesianMarker:

• using DefaultCartesianMarker, described below
• creating a custom implementation of the interface

DefaultCartesianMarker

A common means of creating CartesianMarkers is DefaultCartesianMarker, which accepts three main components—a label, a point indicator, and a vertical line—and offers several customization options.

Compose

Create DefaultCartesianMarker instances via rememberDefaultCartesianMarker.

A DefaultCartesianMarker’s label text is created by its CartesianMarkerValueFormatter, which you can change via the valueFormatter parameter of rememberCartesianMarker.

Views

Create DefaultCartesianMarker instances via the class constructor.

A DefaultCartesianMarker’s label text is created by its CartesianMarkerValueFormatter, which you can change via the valueFormatter parameter of the DefaultCartesianMarker constructor.

A dedicated formatting contract is required here because CartesianMarkers can highlight multiple points at once. The general principle is the same as with CartesianValueFormatter, but the required information must first be retrieved from targets.

The default CartesianMarkerValueFormatter implementation is DefaultCartesianMarkerValueFormatter, which uses DecimalFormat to format y values. DefaultCartesianMarkerValueFormatter lets you provide a custom DecimalFormat instance and toggle the color-coding of y values. You can use a custom DecimalFormat instance not only to change how the y values themselves are formatted, but also to add prefixes and suffixes.

DefaultCartesianMarker is open for subclassing.

CartesianMarkerVisibilityListener

You can listen for visibility changes of standard CartesianMarkers via CartesianMarkerVisibilityListener.

Compose

Add a CartesianMarkerVisibilityListener via the markerVisibilityListener parameter of CartesianChartHost.

Views

Add a CartesianMarkerVisibilityListener via CartesianChartView#markerVisibilityListener.