PieChart
Кольцевая диаграмма долей: каждый элемент data — сегмент с подписью, значением и необязательным цветом. При наведении сегмент выдвигается, а в центре диаграммы появляются его подпись (обрезается до 15 символов) и значение. Слева от диаграммы — основная легенда со всеми сегментами, справа — необязательная агрегированная легенда, например сводка по группам.
Размер задаётся options.width / options.height в px; без них диаграмма занимает 100% родителя.
Когда использовать
-
Доли целого по небольшому числу категорий: расходы по сервисам, распределение ресурсов по проектам.
-
Сводка с переходом к деталям: клик по сегменту или пункту легенды открывает страницу категории.
-
Больше 8–10 категорий:
- объедините мелкие в «Прочее» или используйте
InteractiveChartсо столбцами.
- объедините мелкие в «Прочее» или используйте
-
Одна величина относительно лимита:
- используйте
BagelChart.
- используйте
-
✅ Сортируйте
dataпо убываниюvalue— крупные доли идут первыми и получают первые цвета палитры. -
❌ Передавать сегменты с нулевым или отрицательным
value. -
✅ Передавайте
idу сегментов и пунктов легенд, если по клику нужна навигация. -
❌ Опираться на
labelкак на идентификатор — подписи могут совпадать и меняться с локализацией. -
✅ Задавайте
colorу сегмента только когда цвет несёт смысл (например, статус). -
❌ Переопределять
colorу всех сегментов ради декора — палитра по умолчанию согласована с темой. -
✅ Выбирайте
typographySizeпод плотность экрана:s— для виджета,l— для отдельной страницы. -
❌ Уменьшать
width/heightтак, что легенды обрезаются — легенды прокручиваются, но заголовок и диаграмма должны оставаться видимыми.
Анатомия
- Заголовок
options.title. - Диаграмма — сегменты с зазором между ними; в центре при наведении — подпись и значение сегмента.
- Основная легенда (слева) — заголовок
options.legendTitleи пункты по сегментам с цветовым маркером. Клик по подписи пункта вызываетonLegendItemClick. - Агрегированная легенда (справа) —
aggregatedLegend.titleи пунктыaggregatedLegend.dataбез цветового маркера. Клик по подписи пункта вызываетaggregatedLegend.onAggregatedLegendItemClick.
Клик по сегменту (по нажатию кнопки мыши) вызывает onPieSegmentClick с элементом data.
Обе легенды прокручиваются, если не помещаются по высоте.
Typography size (default l)
options.typographySize задаёт размер шрифта заголовка и легенд, выставляется на корень атрибутом data-size:
s— компактный виджет на дашборде.m— карточка в сетке.l— отдельная страница или крупный блок.
Цвет сегмента
По умолчанию сегмент получает цвет палитры по индексу (16 цветов, по кругу). Поле color у элемента data переопределяет цвет — принимается любое CSS-значение, включая var(--…).
Установка
pnpm add @cloud-ru/ds-uikit-product-charts
import { PieChart } from '@cloud-ru/ds-uikit-product-charts'
Примеры использования
Клик по сегменту и легенде
Расходы по сервисам
import { PieChart } from '@cloud-ru/ds-uikit-product-charts';
import { useState } from 'react';
const DATA = [
{ id: 'compute', label: 'Compute', value: 420 },
{ id: 'storage', label: 'Object Storage', value: 310 },
{ id: 'network', label: 'Network', value: 180 },
{ id: 'kubernetes', label: 'Managed Kubernetes', value: 150 },
{ id: 'databases', label: 'Databases', value: 95 },
];
type SelectedItem = { label: string | number; value: string | number };
export function ClickableSegments() {
const [selected, setSelected] = useState<SelectedItem>();
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<PieChart
data={DATA}
options={{ title: 'Расходы по сервисам', legendTitle: 'Сервисы', width: 480, height: 240 }}
onPieSegmentClick={setSelected}
onLegendItemClick={setSelected}
/>
<span>Выбрано: {selected ? `${selected.label} — ${selected.value}` : 'ничего'}</span>
</div>
);
}Агрегированная легенда
Расходы за месяц
import { PieChart } from '@cloud-ru/ds-uikit-product-charts';
import { useState } from 'react';
const DATA = [
{ id: 'compute', label: 'Compute', value: 420 },
{ id: 'storage', label: 'Object Storage', value: 310 },
{ id: 'network', label: 'Network', value: 180 },
{ id: 'kubernetes', label: 'Managed Kubernetes', value: 150 },
{ id: 'databases', label: 'Databases', value: 95 },
{ id: 'other', label: 'Other services', value: 45 },
];
const GROUPS = [
{ id: 'infrastructure', label: 'Infrastructure', value: 910 },
{ id: 'platform', label: 'Platform', value: 245 },
{ id: 'other', label: 'Other', value: 45 },
];
type GroupItem = { label: string | number };
export function AggregatedLegend() {
const [group, setGroup] = useState<GroupItem>();
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<PieChart
data={DATA}
options={{ title: 'Расходы за месяц', legendTitle: 'Сервисы', typographySize: 'm', width: 640, height: 260 }}
aggregatedLegend={{ title: 'Группы', data: GROUPS, onAggregatedLegendItemClick: setGroup }}
/>
<span>Группа: {group ? group.label : 'не выбрана'}</span>
</div>
);
}Props
Types
WithSupportProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
aggregatedLegend | PieChartAggregatedLegend | — | no | Дополнительная легенда справа от диаграммы — например, сводка по группам |
className | string | — | no | CSS-класс корня |
data | PieChartDataItem[] | — | yes | Сегменты диаграммы |
data-test-id | string | — | no | |
onLegendItemClick | ((item: PieChartLegendItem) => void) | — | no | Колбэк клика по пункту основной легенды |
onPieSegmentClick | ((item: PieChartDataItem) => void) | — | no | Колбэк клика по сегменту |
options | PieChartOptions | — | yes | Настройки отображения |
Types
WithSupportProps
Storybook
Смотри также
- BagelChart — одна величина относительно лимита.
- InteractiveChart — столбцы и линии для большого числа категорий.