PieChart

Кольцевая диаграмма долей: каждый элемент data — сегмент с подписью, значением и необязательным цветом. При наведении сегмент выдвигается, а в центре диаграммы появляются его подпись (обрезается до 15 символов) и значение. Слева от диаграммы — основная легенда со всеми сегментами, справа — необязательная агрегированная легенда, например сводка по группам.

Размер задаётся options.width / options.height в px; без них диаграмма занимает 100% родителя.

Когда использовать

  • Доли целого по небольшому числу категорий: расходы по сервисам, распределение ресурсов по проектам.

  • Сводка с переходом к деталям: клик по сегменту или пункту легенды открывает страницу категории.

  • Больше 8–10 категорий:

    • объедините мелкие в «Прочее» или используйте InteractiveChart со столбцами.
  • Одна величина относительно лимита:

  • ✅ Сортируйте 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'

Примеры использования

Клик по сегменту и легенде

Клик по сегменту и легендеonPieSegmentClick и onLegendItemClick сохраняют выбранную категорию

Расходы по сервисам

Compute420Object Storage310Network180Managed Kuberne...150Databases95
Выбрано: ничего
tsx
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>
  );
}

Агрегированная легенда

Агрегированная легендаСводка по группам справа от основной легенды, typographySize m

Расходы за месяц

Compute420Object Storage310Network180Managed Kuberne...150Databases95Other services45
Группа: не выбрана
tsx
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

PropsWithSupportProps
PropTypeDefaultRequiredDescription
aggregatedLegendPieChartAggregatedLegend—noДополнительная легенда справа от диаграммы — например, сводка по группам
classNamestring—noCSS-класс корня
dataPieChartDataItem[]—yesСегменты диаграммы
data-test-idstring—no
onLegendItemClick((item: PieChartLegendItem) => void)—noКолбэк клика по пункту основной легенды
onPieSegmentClick((item: PieChartDataItem) => void)—noКолбэк клика по сегменту
optionsPieChartOptions—yesНастройки отображения

Types

WithSupportProps

Storybook

Смотри также

  • BagelChart — одна величина относительно лимита.
  • InteractiveChart — столбцы и линии для большого числа категорий.