Charts

Scatter Chart

Plot data points on an X-Y plane to visualize relationships

Scatter charts display individual data points on a two-dimensional plane, useful for showing relationships between variables.

Simple Scatter Chart

A scatter chart with two data series and a size axis.

Usage

Each <Scatter> receives its own data array (unlike other chart types where data is on the chart container):

<ScatterChart>
  <XAxis data-key="x" type="number" />
  <YAxis data-key="y" type="number" />
  <Scatter name="Series A" :data="data01" fill="#8884d8" />
  <Scatter name="Series B" :data="data02" fill="#82ca9d" />
</ScatterChart>

Use <ZAxis> to map a third dimension to dot size:

<ZAxis data-key="z" :range="[60, 400]" />

ScatterChart props

PropTypeDefaultDescription
widthnumberChart width
heightnumberChart height
layout'horizontal' | 'vertical''horizontal'Layout direction

Scatter props

PropTypeDefaultDescription
dataArrayData array for this scatter series
dataKeystring | number | FunctionKey for Y values
namestringName for legend/tooltip
fillstringDot fill color
linebooleanfalseConnect dots with a line
shapestring'circle'Dot shape (circle, cross, diamond, square, star, triangle, wye)
hidebooleanfalseHide the scatter
isAnimationActivebooleantrueEnable animation

ZAxis props

PropTypeDefaultDescription
dataKeystring | numberKey for Z values
range[number, number][64, 64]Min and max dot size
Copyright © 2026