BagelChart
Кольцевой индикатор «занято из общего объёма»: сегмент кольца пропорционален value / total, в центре — отформатированные value и total (формат чисел — по текущему языку из @cloud-ru/ds-locale). Над кольцом выводится необязательный заголовок title.
У кольца нет собственной ширины — оно заполняет ширину контейнера, минимальная ширина задана токеном.
Демо
titletotalvalue<BagelChart title="vCPU" value={48} total={128} />Когда использовать
-
Одна величина относительно лимита: квота, заполненность хранилища, занятые ядра.
-
Компактная сводка на дашборде, где важен уровень, а не точное значение.
-
Несколько величин с разными единицами:
- используйте несколько
BagelChartрядом, по одному на величину.
- используйте несколько
-
Доли нескольких категорий в целом:
- используйте
PieChart.
- используйте
-
✅ Задавайте ширину контейнера кольца явно.
-
❌ Растягивать кольцо на всю ширину широкой колонки — подписи в центре масштабируются вместе с ним.
-
✅ Передавайте в
titleназвание ресурса с единицами измерения. -
❌ Дублировать в
titleзначенияvalueиtotal— они уже выводятся в центре кольца. -
✅ Держите
valueиtotalв одних единицах. -
❌ Передавать
valueбольше 9 999 999 илиtotalбольше 999 999 999 — числа не помещаются в центр кольца, в dev-режиме выводится предупреждение. -
✅ Показывайте рядом с кольцом текстовое значение, если цвет уровня важен для решения пользователя.
-
❌ Полагаться только на цвет сегмента как на носитель смысла.
Анатомия
- Заголовок
title— над кольцом, необязательный. - Кольцо — трек нейтрального цвета и сегмент заполненности, начинается сверху и идёт по часовой стрелке.
- Подписи в центре —
value(крупно) иtotal(под ним).
Уровень заполненности
Цвет сегмента выбирается автоматически по доле value / total и выставляется на корень атрибутом data-level:
low— до 50% включительно, зелёный.medium— больше 50% и до 75% включительно, жёлтый.high— больше 75%, красный.
Отдельного пропа для цвета нет: уровень выводится только из данных.
Установка
pnpm add @cloud-ru/ds-uikit-product-charts
import { BagelChart } from '@cloud-ru/ds-uikit-product-charts'
Примеры использования
Квоты проекта
import { BagelChart } from '@cloud-ru/ds-uikit-product-charts';
const QUOTAS = [
{ title: 'vCPU', value: 32, total: 128 },
{ title: 'RAM, GB', value: 180, total: 256 },
{ title: 'SSD, GB', value: 920, total: 1000 },
];
export function QuotaUsage() {
return (
// Кольцо заполняет ширину контейнера: колонки сетки задают его размер.
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(3, 160px)', gap: 12 }}>
{QUOTAS.map(quota => (
<BagelChart key={quota.title} title={quota.title} value={quota.value} total={quota.total} />
))}
</div>
);
}Props
Types
BagelChartProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
className | string | — | no | CSS-класс корня |
data-test-id | string | — | no | |
title | ReactNode | — | no | Заголовок над кольцом |
total | number | — | yes | Общий объём, от которого считается заполненность |
value | number | — | yes | Занятое значение. Определяет длину сегмента и его цвет: до 50% — зелёный, до 75% — жёлтый, выше — красный |
Types
BagelChartProps
Storybook
Смотри также
- PieChart — доли нескольких категорий.
- ProgressBar — линейный индикатор заполненности.