Preview Updated 2026-05-10

Donut chart

Hollow pie chart that can show a value or label in the center.

Basic usage

Data is passed in via props. Pure SVG rendering, no third-party chart library dependency. Colors come from the --viz-1..8 tokens and are colorblind-friendly.

背景

Chrome 65.0%
Safari 18.0%
Firefox 9.0%
Edge 5.0%
Other 3.0%

src/App.vue

<script setup lang="ts">
import { CfDonutChart } from '@chufix-design/vue';
const segments = [
  { name: 'Chrome', value: 65 },
  { name: 'Safari', value: 18 },
  { name: 'Firefox', value: 9 },
  { name: 'Edge', value: 5 },
  { name: 'Other', value: 3 },
];
</script>
<template>
  <CfDonutChart :segments="segments" :size="200" :thickness="28" center-value="100%" center-label="访问占比" />
</template>

<script setup>
import { CfDonutChart } from '@chufix-design/vue';
const segments = [
  { name: 'Chrome', value: 65 },
  { name: 'Safari', value: 18 },
  { name: 'Firefox', value: 9 },
  { name: 'Edge', value: 5 },
  { name: 'Other', value: 3 },
];
</script>
<template>
  <CfDonutChart :segments="segments" :size="200" :thickness="28" center-value="100%" center-label="访问占比" />
</template>

import { CfDonutChart } from '@chufix-design/react';

export default function Demo() {
  return (
    <>
      <CfDonutChart ... />
    </>
  );
}

Different ring thicknesses

thickness controls the ring thickness (with the same size, thicker is more pie-like, thinner is more ring-like).

背景

src/App.vue

<script setup lang="ts">
import { CfDonutChart } from '@chufix-design/vue';
const segments = [
  { name: '已完成', value: 78 },
  { name: '进行中', value: 14, colorIndex: 4 },
  { name: '未开始', value: 8, colorIndex: 5 },
];
</script>
<template>
  <div class="demo-row" style="gap: 32px; align-items: center;">
    <CfDonutChart :segments="segments" :size="160" :thickness="14" :show-legend="false" center-value="78%" center-label="完成率" />
    <CfDonutChart :segments="segments" :size="160" :thickness="22" :show-legend="false" center-value="78%" center-label="完成率" />
    <CfDonutChart :segments="segments" :size="160" :thickness="32" :show-legend="false" center-value="78%" center-label="完成率" />
  </div>
</template>

<script setup>
import { CfDonutChart } from '@chufix-design/vue';
const segments = [
  { name: '已完成', value: 78 },
  { name: '进行中', value: 14, colorIndex: 4 },
  { name: '未开始', value: 8, colorIndex: 5 },
];
</script>
<template>
  <div class="demo-row" style="gap: 32px; align-items: center;">
    <CfDonutChart :segments="segments" :size="160" :thickness="14" :show-legend="false" center-value="78%" center-label="完成率" />
    <CfDonutChart :segments="segments" :size="160" :thickness="22" :show-legend="false" center-value="78%" center-label="完成率" />
    <CfDonutChart :segments="segments" :size="160" :thickness="32" :show-legend="false" center-value="78%" center-label="完成率" />
  </div>
</template>

import { CfDonutChart } from '@chufix-design/react';

export default function Demo() {
  const segments = [
    { name: '已完成', value: 78 },
    { name: '进行中', value: 14, colorIndex: 4 },
    { name: '未开始', value: 8, colorIndex: 5 },
  ];
  return (
    <>
      <CfDonutChart segments={data} thickness={14} centerValue="78%" centerLabel="Completion" />
      <CfDonutChart segments={data} thickness={22} />
      <CfDonutChart segments={data} thickness={32} />
    </>
  );
}

API

Prop	Type	Default	Description
`segments`	`DonutSegment[]`	`—`	{ name, value, colorIndex? }[]
`size`	`number`	`180`	Diameter
`thickness`	`number`	`24`	Ring thickness
`centerValue / centerLabel`	`string \| number`	`—`	Center text
`showLegend`	`boolean`	`true`