Charts
Radial Metrics
Несколько показателей одним объектом: концентрические дуги на общем центре и легенда с процентами и абсолютными числами.
- chart
- radial
- progress
- metrics
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/chart-020
- Покрытие тестами82%82 из 100
- Готовность спринта64%64 из 100
- Доля автосборок45%45 из 100
Единица измерения: процентов от цели
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «chart-020» (Radial Metrics) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/chart-020.json
Registry item: https://vibeui.ru/r/chart-020.json
Ставится в: components/vibeui/chart-020.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Несколько показателей одним объектом: концентрические дуги на общем центре и легенда с процентами и абсолютными числами.
Радиальный прогресс нескольких метрик: концентрические дуги на общем центре, подложка каждой дуги, легенда с процентом и абсолютным «значение из предела». Ноль зависимостей, один файл, клиентского JS нет.
## 3. Как использовать
import { Chart020 } from "@/components/vibeui/chart-020"
<Chart020
title="Готовность релиза"
unit="процентов от цели"
metrics={[{ label: "Покрытие тестами", value: 82, max: 100 }]}
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-chart-020-* и не подменять её токенами вашей темы (bg-card, --chart-1 и подобными)
- легенду с процентами: кольца разного радиуса на глаз не сравниваются вообще никак
- абсолютное «значение из предела» рядом с процентом — 80% от пяти и от пятисот это разные новости
- подложку под каждой дугой: без неё непонятно, где конец шкалы
- поворот на −90°, чтобы дуги начинались сверху, а не справа
- aria-hidden на svg: смысл несёт легенда, а не картинка
## 6. Можно менять
- массив metrics: подпись, значение, предел max и оттенок
- title — заголовок карточки
- unit — единица измерения в подписи под легендой
- акцент через проп accent — цвет внешней дуги
- радиусы и толщину дуг
## 7. Правила
- Больше четырёх метрик не помещается: лишние молча отбрасываются, потому что радиусов ровно четыре.
- Концентрические дуги нельзя сравнивать по длине: внешняя всегда длиннее при равном проценте, поэтому легенда обязательна.
- Значение подрезается диапазоном от нуля до max: перевыполнение дуга не покажет.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/chart-020.jsonhttps://vibeui.ru/r/chart-020.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-chart-020-*. Серверный: хуков нет. Каждая метрика живёт на своей окружности: длина окружности считается из радиуса, заполнение задаётся stroke-dasharray, поворот на −90° переносит старт наверх. Радиусы лежат отдельным массивом, поэтому геометрию можно менять, не трогая математику. Кольцо помечено aria-hidden: смысл несёт легенда, где у каждой метрики есть и процент, и «значение из предела».
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Chart020Metric = {
label: string
value: number
max?: number
hue?: number
}
export type Chart020Props = Omit<
ComponentPropsWithoutRef<"figure">,
"children" | "title"
> & {
title?: string
metrics?: Chart020Metric[]
unit?: string
accent?: string
}
// Идея компонента: несколько показателей одним объектом — концентрические
// дуги. Каждая дуга живёт на своей окружности и заполняется через
// stroke-dasharray, поэтому радиусы можно менять, не трогая математику.
// Кольца сами по себе неразличимы, поэтому легенда с процентами обязательна.
const STYLES = `
:where([data-vibeui-block="chart-020"]){
--vibeui-chart-020-bg:oklch(1 0 0);
--vibeui-chart-020-fg:oklch(0.22 0.014 265);
--vibeui-chart-020-muted:oklch(0.55 0.014 265);
--vibeui-chart-020-border:oklch(0.91 0.006 265);
--vibeui-chart-020-track:oklch(0.95 0.004 265);
--vibeui-chart-020-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="chart-020"]{
display:flex;flex-wrap:wrap;align-items:center;gap:0.875rem;
width:100%;max-width:26rem;box-sizing:border-box;margin:0;padding:0.875rem;
background:var(--vibeui-chart-020-bg);
border:1px solid var(--vibeui-chart-020-border);border-radius:0.875rem;
color:var(--vibeui-chart-020-fg);font-family:var(--vibeui-chart-020-font);
}
[data-vibeui-block="chart-020"] [data-part="title"]{flex:1 0 100%;margin:0;font-size:0.875rem;font-weight:650}
[data-vibeui-block="chart-020"] svg{display:block;width:8.75rem;height:8.75rem;flex:0 0 auto}
[data-vibeui-block="chart-020"] [data-part="track"]{
fill:none;stroke:var(--vibeui-chart-020-track);stroke-width:9;
}
[data-vibeui-block="chart-020"] [data-part="ring"]{
fill:none;stroke-width:9;stroke-linecap:round;
}
[data-vibeui-block="chart-020"] [data-part="legend"]{
flex:1 1 9rem;display:flex;flex-direction:column;gap:0.5rem;margin:0;padding:0;list-style:none;
}
[data-vibeui-block="chart-020"] [data-part="row"]{
display:grid;grid-template-columns:0.5rem 1fr auto;align-items:center;gap:0.5rem;
font-size:0.8125rem;
}
[data-vibeui-block="chart-020"] [data-part="chip"]{
width:0.5rem;height:0.5rem;border-radius:9999px;background:var(--vibeui-chart-020-ring);
}
[data-vibeui-block="chart-020"] [data-part="name"]{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
[data-vibeui-block="chart-020"] [data-part="share"]{font-weight:650;font-variant-numeric:tabular-nums}
[data-vibeui-block="chart-020"] [data-part="raw"]{
grid-column:2 / -1;font-size:0.6875rem;color:var(--vibeui-chart-020-muted);
font-variant-numeric:tabular-nums;
}
[data-vibeui-block="chart-020"] [data-part="unit"]{flex:1 0 100%;margin:0;font-size:0.75rem;color:var(--vibeui-chart-020-muted)}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="chart-020"] *{animation:none!important;transition:none!important}}
`
const CENTER = 60
const RADII = [50, 38, 26, 14]
const HUES = [265, 200, 150, 40]
const DEFAULT_METRICS: Chart020Metric[] = [
{ label: "Покрытие тестами", value: 82, max: 100 },
{ label: "Готовность спринта", value: 64, max: 100 },
{ label: "Доля автосборок", value: 45, max: 100 },
]
/**
* Радиальный прогресс нескольких метрик концентрическими дугами.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Chart020({
title = "Готовность релиза",
metrics = DEFAULT_METRICS,
unit = "процентов от цели",
accent,
className,
style,
...props
}: Chart020Props) {
const palette = {
...(accent ? { "--vibeui-chart-020-accent": accent } : null),
...style,
} as CSSProperties
const rings = metrics.slice(0, RADII.length).map((metric, index) => {
const ceiling = metric.max ?? 100
const share = Math.max(0, Math.min(1, metric.value / (ceiling || 1)))
const radius = RADII[index]
const circumference = 2 * Math.PI * radius
return {
metric,
ceiling,
share,
radius,
circumference,
color:
accent && index === 0
? accent
: `oklch(0.6 0.15 ${metric.hue ?? HUES[index % HUES.length]})`,
}
})
return (
<>
<style href="vibeui-chart-020" precedence="medium">
{STYLES}
</style>
<figure
{...props}
data-vibeui-block="chart-020"
className={className}
style={palette}
>
<figcaption data-part="title">{title}</figcaption>
<svg viewBox="0 0 120 120" aria-hidden="true" focusable="false">
{rings.map((ring) => (
<g key={ring.metric.label}>
<circle
data-part="track"
cx={CENTER}
cy={CENTER}
r={ring.radius}
/>
<circle
data-part="ring"
cx={CENTER}
cy={CENTER}
r={ring.radius}
stroke={ring.color}
strokeDasharray={`${ring.circumference * ring.share} ${ring.circumference}`}
transform={`rotate(-90 ${CENTER} ${CENTER})`}
/>
</g>
))}
</svg>
<ul data-part="legend">
{rings.map((ring) => (
<li key={ring.metric.label} data-part="row">
<span
data-part="chip"
aria-hidden="true"
style={
{ "--vibeui-chart-020-ring": ring.color } as CSSProperties
}
/>
<span data-part="name">{ring.metric.label}</span>
<span data-part="share">{Math.round(ring.share * 100)}%</span>
<span data-part="raw">
{ring.metric.value} из {ring.ceiling}
</span>
</li>
))}
</ul>
<p data-part="unit">Единица измерения: {unit}</p>
</figure>
</>
)
}