BagelChart

Кольцевой индикатор «занято из общего объёма»: сегмент кольца пропорционален value / total, в центре — отформатированные value и total (формат чисел — по текущему языку из @cloud-ru/ds-locale). Над кольцом выводится необязательный заголовок title.

У кольца нет собственной ширины — оно заполняет ширину контейнера, минимальная ширина задана токеном.

Демо

Preview
vCPU
48128
Prop
Type
Value
title
text
total
number
value
number
Code
<BagelChart title="vCPU" value={48} total={128} />

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

  • Одна величина относительно лимита: квота, заполненность хранилища, занятые ядра.

  • Компактная сводка на дашборде, где важен уровень, а не точное значение.

  • Несколько величин с разными единицами:

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

  • ✅ Задавайте ширину контейнера кольца явно.

  • ❌ Растягивать кольцо на всю ширину широкой колонки — подписи в центре масштабируются вместе с ним.

  • ✅ Передавайте в 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'

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

Квоты проекта

Квоты проектаТри кольца с уровнями low, medium и high
vCPU
32128
RAM, GB
180256
SSD, GB
9201,000
tsx
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

PropsBagelChartProps
PropTypeDefaultRequiredDescription
classNamestring—noCSS-класс корня
data-test-idstring—no
titleReactNode—noЗаголовок над кольцом
totalnumber—yesОбщий объём, от которого считается заполненность
valuenumber—yesЗанятое значение. Определяет длину сегмента и его цвет: до 50% — зелёный, до 75% — жёлтый, выше — красный

Types

BagelChartProps

Storybook

Смотри также

  • PieChart — доли нескольких категорий.
  • ProgressBar — линейный индикатор заполненности.