2.0.0-alpha.13

This release introduces column-by-column customization for ColumnCartesianLayer and includes bug fixes.

Breaking changes	Addressed
None	#471, #631, #635, #636

ColumnProvider

Compose

In ColumnCartesianLayer, the new ColumnProvider API enables you to customize each column individually. You can implement the interface and override getColumn to return different LineComponents based on, for example, y value. ColumnProvider.series creates a ColumnProvider implementation with the series-based behavior from previous Vico versions. Follow the instructions in the deprecation messages to migrate to ColumnProvider.

Views

In ColumnCartesianLayer, the new ColumnProvider API enables you to customize each column individually. You can implement the interface and override getColumn to return different LineComponents based on, for example, y value. ColumnProvider.series creates a ColumnProvider implementation with the series-based behavior from previous Vico versions. Follow the instructions in the deprecation messages to migrate to ColumnProvider.

The columnProvider property replaces columns. Migrate as follows:

• If you’re using columns to apply a custom LineComponent list, use the following:

  columnCartesianLayer.columnProvider =
      ColumnCartesianLayer.ColumnProvider.series(LineComponent(...), ...)

  In case your list is defined somewhere else, there’s also a series overload with a List<LineComponent> parameter. (Here, columns is your list, not ColumnCartesianLayer#columns.)

  columnCartesianLayer.columnProvider =
      ColumnCartesianLayer.ColumnProvider.series(columns)

• If you’re using map with ColumnCartesianLayer#columns to customize the default LineComponents, either move this customization to XML, or create and customize your LineComponents fully programmatically.

• If you’re reading the value of columns after updating it, save the LineComponent list to a variable for later access:

  val columns = listOf(LineComponent(...), ...)

  Apply the LineComponent list to the ColumnCartesianLayer like so:

  columnCartesianLayer.columnProvider =
      ColumnCartesianLayer.ColumnProvider.series(columns)

Resolved bugs

• Data labels didn’t work in ColumnCartesianLayers with MergeMode.Stacked applied.
• Markers didn’t work for zero-height columns in ColumnCartesianLayers.
• The default AxisItemPlacer.Horizontal implementation could reduce the label spacing excessively when automatic label spacing was enabled.