Style Defaults
Build chart styles with their *ChartDefaults factories. Shared default values live in
StyleDefaults
in charts-core. Read the current values there when changing a default.
Factories
Chart-specific blocks live on *ChartDefaults. Cartesian axes use the shared AxesDefaults,
AxisLinesDefaults, GridDefaults, and AxisLabelDefaults factories.
BarChartDefaults.style(
axes = AxesDefaults.style(xLabels = AxisLabelDefaults.style(maxCount = 4)),
)- Keep factory nesting shallow: style, axes, then the axis blocks.
- Read numeric and theme defaults from
StyleDefaults. Forwarding factories use the same defaults as the factories they call. - The master axes
visibleswitch gates drawing and label layout. Each child keeps its own visibility setting. - Use
Dpfor lengths so they scale with screen density. Point and marker sizes are radii.
Colors and selection
Use MaterialTheme.colorScheme roles so defaults follow the app's light or dark theme. Keep theme
colors at their supplied opacity and express chart transparency through the style's alpha fields.
Choose a contrasting role for a selection mark drawn over a series. A mark in the series' own color can disappear. Bars and stacked areas also distinguish selection by dimming the unselected region; selection lines stop where they would overlap the selected fill.
Keep opacity exceptions with their reason. Radar fills are translucent so overlapping polygons remain visible. Scatter points are translucent so overlapping observations remain visible. While a selection is active, dimming multiplies the alpha of unselected marks.
Formatters
Use the shared selected-value and axis formatters as defaults where their output fits the chart. Pie formats a slice's share with a percent suffix. Chart-specific factories own any other formatter defaults.
Legend and Selection describes readouts. Y-Axis Labels describes numeric tick formatting.
Adding or changing a default
- Define the value in
StyleDefaultsand update StyleDefaultsTest. - Read it from the style factory and use the same value as the clamping fallback where needed.
- Cover chart-specific behavior in the chart's style tests.
- For a visual change, update and inspect the affected screenshots using Screenshot baselines.
Style Clamping owns drawable-value corrections. Validation Errors owns input and style settings that need an error message.