Donut
Chart and KPI
A donut in one hue ramp with the key value in the center; emphasize only one slice.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.
git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이
src/components/taster에 들어갑니다.node ../taster/packages/engine/cli.mjs add blocks/donut --from https://taster-six.vercel.app --dir src/components/taster부품은 Tailwind 클래스로 그리고, Taster 프리셋이 그 클래스를 토큰에 연결합니다. Tailwind CSS 를 설치하고,
tokens.css를 앱 루트에서 한 번 불러온 뒤, 앱 루트에 이 설정을 둡니다. 프리셋이 없으면 빌드는 되어도 부품이 스타일 없이 나옵니다.// tailwind.config.cjs module.exports = { presets: [require('./src/components/taster/tailwind-preset.cjs')], content: ['./index.html', './src/**/*.{ts,tsx}'], };Tailwind v3 는 이 파일을 그대로 읽습니다. v4 는 Tailwind 를 불러오는
src/의 스타일시트 맨 위에 이 두 줄을 넣습니다.@import "tailwindcss"; @config "../tailwind.config.cjs";tokens.css는:root에--bg,--text,--border,--accent를 정의합니다. 내 앱의 스타일시트가 같은 이름을 뒤에서 다시 정의하면 그쪽 색이 이깁니다. 새 Vite 앱의 스타터 CSS 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- Neutral donutA donut in one hue ramp with the key value in the center; emphasize only one slice.
대신 없애 주는 AI 티
- Rainbow charts (AC-13)
정보
코드 보기
import * as React from 'react'
import { cn } from './_cn'
// Donut chart. Portion segments drawn with stroke-dasharray, total label in the middle.
// Segments use the neutral lightness ramp (chart-1 to chart-6), never a rainbow.
export interface DonutSegment {
label: string
value: number
}
export interface DonutChartProps extends React.HTMLAttributes<HTMLDivElement> {
segments: DonutSegment[]
size?: number
}
const RAMP = [
'stroke-chart-1',
'stroke-chart-2',
'stroke-chart-3',
'stroke-chart-4',
'stroke-chart-5',
'stroke-chart-6',
] as const
const DOT = [
'bg-chart-1',
'bg-chart-2',
'bg-chart-3',
'bg-chart-4',
'bg-chart-5',
'bg-chart-6',
] as const
export const DonutChart = React.forwardRef<HTMLDivElement, DonutChartProps>(
({ segments, size = 140, className, ...props }, ref) => {
const total = segments.reduce((sum, s) => sum + s.value, 0)
const stroke = Math.max(10, Math.round(size * 0.1))
const r = (size - stroke) / 2
const cx = size / 2
const C = 2 * Math.PI * r
let acc = 0
const arcs = segments.map((s, i) => {
const frac = total > 0 ? s.value / total : 0
const arc = { frac, offset: acc, ramp: RAMP[i % RAMP.length] }
acc += frac
return arc
})
return (
<div ref={ref} className={cn('inline-flex flex-col gap-4', className)} {...props}>
<div className="relative" style={{ width: size, height: size }}>
<svg
width={size}
height={size}
viewBox={`0 0 ${size} ${size}`}
aria-hidden="true"
className="-rotate-90"
>
<circle
cx={cx}
cy={cx}
r={r}
fill="none"
strokeWidth={stroke}
className="stroke-border-soft"
/>
{arcs.map((a, i) => (
<circle
key={i}
cx={cx}
cy={cx}
r={r}
fill="none"
strokeWidth={stroke}
strokeDasharray={`${a.frac * C} ${C}`}
strokeDashoffset={-a.offset * C}
className={a.ramp}
/>
))}
</svg>
<div className="absolute inset-0 flex flex-col items-center justify-center">
<span className="text-h2 font-semibold tabular-nums text-text">
{total.toLocaleString('en-US')}
</span>
<span className="text-caption text-text-subtle">Total</span>
</div>
</div>
<ul className="flex flex-col gap-1.5">
{segments.map((s, i) => (
<li key={i} className="flex items-center gap-2 text-sm">
<span
className={cn('size-2 shrink-0 rounded-full', DOT[i % DOT.length])}
aria-hidden="true"
/>
<span className="flex-1 text-text-muted">{s.label}</span>
<span className="tabular-nums font-medium text-text">
{s.value.toLocaleString('en-US')}
</span>
</li>
))}
</ul>
</div>
)
},
)
DonutChart.displayName = 'DonutChart'