Skip to content

datumColor

datumColor(theme, ds, seriesIdx, dataIdx, colorFn?, paletteIdx?): string

Defined in: core/draw.ts:46

Resolve a single datum’s colour using the layered precedence:

  1. colorFn(value, dataIdx, seriesIdx, ds) — chart-level callback
  2. ds.colors[dataIdx] — per-datum array
  3. ds.color — series override
  4. theme.colors[paletteIdx % len] — palette fallback

paletteIdx defaults to seriesIdx, which is right for the common case of multi-series charts (one palette colour per series). Single-series charts where each datum should pick the next palette colour — pie, treemap, funnel, radial bar — pass paletteIdx = dataIdx instead.

Each layer is gated behind a single truthiness check so the hot path stays branch-light.

Theme

Dataset | undefined

number

number

ColorFn

number = seriesIdx

string