Skip to content
WunderUI

Radial Chart

Pro

Radial chart for progress against a goal: radial bars, a stacked ring, a progress ring and activity rings.

Playground

Browser share

Radial chart, 4 parts: Chrome 78, Safari 61, Firefox 34, Edge 22.
Browser share, data table
nameValue
Chrome78
Safari61
Firefox34
Edge22

Installation

Radial Chart comes with WunderUI Core and Pro, in the package from your plan. See the plans.

The charts live in their own entry point: import the chart, its card and its hooks from @wunderui/react/charts, not from @wunderui/react.

Then import what you need:

tsx
import {
  RadialChart,
  RadialChartProps,
  RadialChartVariant,
} from "@wunderui/react/charts"

Then use it:

tsx
import { RadialChart } from "@wunderui/react/charts"

const data = [
  { name: "Chrome", value: 78 },
  { name: "Safari", value: 61 },
  { name: "Firefox", value: 34 },
]

export function BrowserShare() {
  return <RadialChart data={data} index="name" max={100} label="Browser share" />
}

Expected result: You should see three concentric rings, the outer one the longest. Hovering a ring shows its value in the centre.

When to use

Use Radial Chart for

  • Progress against a goal, one ring per row
  • A single completion ring with a number in the middle
  • Concentric rings of different targets, as in an activity view

Use something else for

States

Loading, empty and error keep the chart's size, so the card never jumps. Add a retry handler and the error state offers a Try again button.

Browser share

Radial chart, 4 parts: Chrome 78, Safari 61, Firefox 34, Edge 22.
Browser share, data table
nameValue
Chrome78
Safari61
Firefox34
Edge22

Colour ramps

The success palette paints each ring from red at the start to green as it nears its goal; the heat palette runs from green while it is cool to red when it runs hot. The ramp follows the sweep of the ring and shows up to the value; the centre number stays in the foreground colour.

Goal progress

Radial chart, 3 parts: Onboarding 92, Activation 64, Retention 38.
Goal progress, data table
nameValue
Onboarding92
Activation64
Retention38

Ring count

Every ring count uses the same formula for ring width and gap, so two rings and six rings look like one family and the centre always keeps room for its number. At rest the centre shows the first row; hover a ring to count to it. On enter the tracks bloom first, then the values draw.

Browser share

Radial chart, 2 parts: Chrome 78, Safari 61.
Browser share, data table
nameValue
Chrome78
Safari61

Keyboard interactions

The plot is focusable: Arrow keys step through the rings and the live region announces each one with its value.

TaborShiftTab
Moves focus to the plot and away from it. The plot is one tab stop; so is every legend badge.
ArrowRightorArrowLeft
Moves to the next or previous ring. The tooltip follows, and a live region announces the one you are on. The first press starts at the first one (Left: the last one).
HomeorEnd
Jumps to the first or last ring.
Escape
Clears the active point.
EnterorSpace
On a legend badge of a ChartCard: switches its series off or on. The last visible series stays on.

Behavior and motion

What the chart does on its own and what the page decides.

Rings
Data rows are the rings, outermost first. Each ring is read against the max (default 100), so a full circle is 100 percent of its own target.
Centre number
The centre shows the first row at rest (the total on the stacked variant) and the hovered ring while you point at one. A formatter replaces the percent and a centre label sets the text under it.
Stacked ring
The stacked variant opens the ring at the bottom and splits the arc into segments, one per row.
Tooltip
The tooltip takes its form from the chart's own width, like Area, Line and Bar: under 360 px it docks over the top of the chart at its full width, under 560 px it is the compact card, above that the standard card that follows the pointer.
Loading, empty and error
The chart keeps its size while loading, empty or failed, so the card never changes height. Add a retry handler to show a Try again button on error.
Legend
In a ChartCard, each series badge is a button that switches its series off, but the last visible series stays on. A legend of roles can be made static.
Data table
The chart renders its data as a table for screen readers, in the same order as the plot.
Size
The chart fills the width of its container and you set the plot height. Text never scales, so labels keep their size at every width.

Motion

The enter sequence and the hover follow the motion tokens of the library.

Draw-in
Rings are drawn along their arc when the chart first comes into view, after loading and when new data arrives. The animation can be turned off.
Hover
The ring under the pointer stays, the others dim, and the centre counts to its value.
Reduced motion
With reduced motion on, the chart appears at once without the enter sequence. The tooltip and every state still work.

Anatomy

RadialChart draws values as arcs: concentric rings, a stacked three-quarter ring or a single progress ring. Each ring is read against its own max, so a full circle means 100 percent of its target.

Browser share

Radial chart, 4 parts: Chrome 78, Safari 61, Firefox 34, Edge 22.
Browser share, data table
nameValue
Chrome78
Safari61
Firefox34
Edge22
  • Pass data with the row name and value fields. The max is the value of a full ring (default 100), the centre label is the text under the centre number, and rings follow the row order, outermost first.

  • data-slot="chart-plot"

    The focusable region. Arrow keys step through the rings and announce each one with its value.

  • data-slot="chart-marks"

    Two phases on first view: the tracks bloom, then the value arcs draw along them. Ring width and gap come from one formula for every ring count. The ring under the pointer stays, the others dim, and the centre counts to its value.

  • Optional

    The percentage of the hovered ring; at rest the first row (radial bars and progress ring) or the total (stacked ring). It counts up as the chart enters and its size follows the free space inside the rings. A custom formatter replaces the default percent.

  • data-slot="chart-tooltip"Optional

    The row name and its value for the ring under the pointer.

  • data-slot="chart-message"Optional

    One muted ring on the progress and stacked variants, three concentric rings on the others, with the shimmer over them. The same shape sits faintly behind the empty and error messages.

  • A table of the rows and values for screen readers, with the live region for the active ring.

Best practices

  • Do

    Keep to three or four rings. Inner rings are short, so a fifth ring is too small to compare with the first.

  • Do

    Set the max per chart, not per ring. Rings with different maxima read as if they shared a scale, so show the target in the label if targets differ.

  • Do

    Order rings by importance, outermost first, and name each in the legend or tooltip. Colour alone does not tell the rings apart.

  • Don’t

    Don't use rings for values above 100 percent of the target. The arc stops at a full circle, so show an overshoot in the number.

  • Don’t

    Don't use the stacked variant as a pie with a gap. It is for parts of one total in a three-quarter arc, with the sum in the centre.

API reference

One table for RadialChart, listing every prop. A ChartCard around it takes its own props, and the chart works without one.

Pass data with the row name and value fields. The max is the value of a full ring (default 100), the centre label is the text under the centre number, and rings follow the row order, outermost first.

PropTypeDefaultDescription
data requiredreadonly ChartDatum[]—One object per slice / ring / axis.
index requiredstring—Field holding the label.
valuestring—Field holding the value. Default "value".
variant"radial-bar" | "radial-stacked" | "progress-ring" | "multi-ring-progress""radial-bar"Figma variant. Default .
maxnumber100Value of a full ring (default 100).
colorsreadonly ChartColor[]—Colours per row, in order (palette names or token expressions).
centerLabelstring—Small text under the centre value.
valueFormatterChartValueFormatter—
labelstring—Accessible name, e.g. the card title.
heightnumber—Height of the plot frame in px. Default 280 (Figma small card plot).
state"ready" | "loading" | "empty" | "error"—
hiddenSeriesreadonly string[]—Labels of rows switched off in the legend: drawn faded.
palette"series" | "heat" | "success""series"A colour ramp that follows each ring's sweep: heat runs from green to red (load, temperature), success from red to green (progress towards a goal). The centre number stays in the foreground colour.
activeIndexnumber | null—The active point (hovered or focused) as an index into , to control it yourself. shows none.
animateboolean—
animationKeystring | number—
defaultActiveIndexnumber | null—The point that is active at first, for an uncontrolled chart. It shows the tooltip without a pointer.
descriptionstring—
emptyDescriptionstring—Text under the title in the empty state.
emptyTitlestring—Title of the message in the empty state.
errorDescriptionstring—Text under the title in the error state.
errorTitlestring—Title of the message in the error state.
onActiveIndexChange(index) => void—Called with the index when the pointer or the arrow keys move to another point, and with when they leave. Use it to show the hovered value in a headline.
onRetry() => void—Shows a Try again button in the error state and calls this when it is pressed.
tooltipboolean—
widthnumber—

Notes for AI

Give your coding assistant the Markdown reference instead of screenshots.

MCPget_component("radial-chart")
InstallIncluded in Core and Pro

The full library index for assistants is at /llms.txt.