Skip to Content
kindui

Motion

Turn chart entrances on or off, and tune their timing and direction.

Charts animate with Motion. Set animate on a chart to reveal its marks when it mounts: true for the family's entrance, an options object to tune it, or false for a still chart. Line charts animate by default; every other family starts still until you set animate.

<BarChart animate data={data} config={config} aria-label="Daily orders">

Entrances

Each family enters in its own way, and each chart page shows its own:

ChartEntrance
Line, AreaLines and areas draw in across the plot
Bar, Histogram, Waterfall, Box PlotMarks grow from the baseline
ComboEach line, area and bar series enters in its own way
Pie, RadialSlices and bars sweep around the circle
RadarShapes grow out from the center
ScatterPoints fade in where they are
HeatmapCells fade in on a diagonal
SankeyLink paint flows along each link

Hovering or using the keyboard on a chart, or changing its data, finishes the entrance at once, so the reader never inspects a half-drawn mark. The entrance plays again when loading turns off. To replay it at other times, remount the chart with a new key.

Options

Pass an object to animate to tune the entrance:

<LineChart
  animate={{ revealDurationMs: 600, revealEasing: "easeOut", revealDirection: "center-out" }}
  {...props}
>
  • revealDurationMs: how long the entrance takes. 1000ms by default; Scatter uses 700ms and Sankey 450ms.
  • revealEasing: any Motion easing. Cartesian charts default to [0.25, 0.1, 0.25, 1], the others to "easeOut".
  • revealDirection: for Line, Area and Combo, where the reveal starts: left-to-right (the default), right-to-left, center-out or edges-in.
  • hoverTransition: the Motion transition marks use as they dim and brighten on hover. A spring by default.

Pie and radial charts take animationDirection="clockwise" (the default) or "anticlockwise". Combo charts take lineReveal, areaReveal and barReveal to tune each kind of series apart, or false to skip one. Sankey takes only revealDurationMs, and Heatmap only true or false. Each family's options are typed as its own animation type, like LineAnimation or BarAnimation.

animate={false} also stops marks from moving as they dim and brighten. Two other motions are separate: a dashed line's dashAnimation on Line, and the tooltip's valueAnimation="shuffle" on Tooltip.

Loading

While loading is set, each chart shows a placeholder in its own shape until the data arrives; each chart page describes its placeholder. It uses revealDurationMs and revealEasing from animate for its pace, and holds still when the reader prefers reduced motion.

Reduced Motion

When the reader prefers reduced motion, charts skip their entrances and show the final chart, marks stop moving on hover, loading placeholders hold still, and tooltip digits don't roll. Charts follow the preference live, so changing it mid-session takes effect at once. You don't need to do anything for it.

Custom shapes, tooltip content and your own transitions are yours to animate, so give them a still version under prefers-reduced-motion too.