Skip to content

shadcn.io is an independent project built on shadcn/ui

Free

A donut chart for React

Visitors by browser as a pie with a hole in the middle. Slice colors come from the data, and the tooltip names the browser and its count.

The same browser split as a pie, with a hole in the middle. Slice colors come from the data. The tooltip names the browser and its count. The hole is empty.

Use a donut when you want the split and room in the center for a total. This demo leaves the hole blank. Put the total there, or list the rows in a Table. In React, Base UI does not open the hole. You set the inner radius, and you pass the rows.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.
Use email insteadNo credit card

Anatomy

Chart anatomy: container, grid, axis, bar, tooltip, legend

Usage

<div className="w-full max-w-xl rounded-md border bg-background p-4">
  <ChartContainer
    className="mx-auto aspect-square max-h-[250px]"
    config={chartConfig}
  >
    <PieChart>
      <ChartTooltip
        content={<ChartTooltipContent hideLabel />}
        cursor={false}
      />
      <Pie
        data={chartData}
        dataKey="visitors"
        innerRadius={60}
        nameKey="browser"
      />
    </PieChart>
  </ChartContainer>
</div>

FAQ

How is the center hole made?

Pie sets innerRadius to 60. dataKey is visitors and nameKey is browser, so each slice is one browser's visitor count.

How does each slice get its color?

Each row sets fill to a variable such as var(--color-chrome). config maps chrome, safari, firefox, edge, and other to --chart-1 through --chart-5, with labels Chrome, Safari, Firefox, Edge, and Other.

What does the tooltip show?

ChartTooltipContent sets hideLabel, and cursor is false. The slice name comes from nameKey browser, looked up in config, and the value is visitors.

Why is the chart square?

ChartContainer uses mx-auto aspect-square max-h-[250px], so the donut stays square and caps at 250px tall. The outer frame is w-full max-w-xl.

What is the visitors entry in config for?

visitors has the label Visitors and no color. Slice colors live on the browser keys. The tooltip uses those browser labels when it names a slice.

Which counts are in the ring?

Chrome is 275, Safari 200, Firefox 187, Edge 173, and Other 90. The data keys are lowercase. config supplies the display labels.

API Reference

Chart

Sets config={chartConfig} and hideLabel. The rest is on the Chart page.