Skip to main content

Chart types

The seven draw layers. Each is a React component you render inside <Layers>, handed a pond series and told which column to read. They share one shape:

  • series + column — the data and the numeric column to draw. Some layers read fixed column sets instead (lower/upper, OHLC).
  • as — the style channel (a theme.<kind> role lookup). Never a per-component colour/width prop.
  • axis — the scale channel (which <YAxis id> to measure against).

Style and scale are separate on purpose. For the axis and layout mechanics see Axes and Layout; each page below links the generated typedoc for the exhaustive prop types.

LayerDrawsReach for it when
LineChartA gap-aware line through one columnA continuous series over time or a value axis
AreaChartA filled area to a baselineVolume / magnitude, or an above-below split
BandChartA filled envelope between two columnsA variance / confidence band (percentile fan)
ScatterChartPoints, with data-driven radius / colourDiscrete events; a 2-encoding cloud (vol smile)
BarChartBars — buckets, histograms, stacks, categoriesAggregated buckets, distributions, category totals
BoxPlotBox-and-whisker from pre-computed quantilesA distribution per bucket (five quantile columns)
CandlestickOHLC candlesFinancial price bars

Every layer draws identically across a time, value, or (for BarChart) category x axis — the kind follows the data, not the component. BarChart in its bins mode is the histogram; there's no separate Histogram component.

Data adapters

Most layers accept a pond series directly and shape it internally. The from* / stacksFrom* adapters in the package (fromTimeSeries, bandFromTimeSeries, boxFromTimeSeries, ohlcFromTimeSeries, stacksFromColumns, categoryStack, transposeRow, …) are the same shaping made explicit — reach for them when you're building the series shape yourself. Each page's Data contract section names the adapter and columns its layer reads.