InteractiveChart
Обёртка над uPlot: компонент берёт базовую конфигурацию по type, подставляет в неё цвета текущей темы и глубоко сливает поверх неё options. Данные передаются в формате uPlot (AlignedData): первый массив — значения оси X, остальные — серии.
Серии описываются в options.series: первая запись относится к оси X (обычно {}), остальные совпадают по порядку с массивами данных. Хук useLayer собирает серию в цветах палитры SERIES_COLORS — цвет читается с корня графика при отрисовке, поэтому серия следует теме того графика, в котором нарисована.
Размер по умолчанию — 800×600 px, меняется через options.width / options.height. График рисуется на canvas и требует браузерного окружения.
Когда использовать
-
Временные ряды и метрики мониторинга, где нужно приблизить участок графика.
-
Сравнение нескольких серий на одних осях.
-
Статистическое распределение по группам —
type='boxPlot'. -
Доли целого:
- используйте
PieChart.
- используйте
-
Матрица значений по двум категориальным осям:
- используйте
HeatMapChart.
- используйте
-
✅ Мемоизируйте
options(useMemo) — новая ссылка наoptionsпересоздаёт график. -
❌ Собирать
optionsлитералом прямо в JSX на каждый рендер. -
✅ Задавайте цвета серий через
useLayerиSERIES_COLORS. -
❌ Передавать в
stroke/fillсерии фиксированные цвета — они не переключаются вместе с темой. -
✅ Подписывайте оси и серии через
options.axes[i].labelиlabelвuseLayer— базовые конфигурации подписей не содержат. -
❌ Выводить больше 5–6 серий на одном графике — линии сливаются.
-
✅ Для box plot передавайте ровно шесть массивов:
[x, min, q1, median, q3, max]. -
❌ Переопределять
options.seriesу box plot — порядок серий задаёт формат данных и подписи в тултипе.
Анатомия
- Область графика (canvas uPlot) с осями X и Y и сеткой.
- Серии — линии, столбцы или точки в цветах палитры.
- Легенда uPlot под графиком; у
boxPlotона работает как тултип рядом с курсором.
Type (default default)
type выбирает базовую конфигурацию, значение выставляется на корень атрибутом data-type. Значения — константа PLOT_TYPES:
default— оси X/Y без временной шкалы. Выделение области мышью приближает её, колесо мыши масштабирует, зажатая средняя кнопка перемещает график по X, двойной клик сбрасывает масштаб.boxPlot— «ящик с усами» по группам: усы min–max, тело q1–q3 и линия медианы. Колонка под курсором подсвечивается, значения выводятся в тултипе. Масштабирование отключено.
Draw style
drawStyle в useLayer — способ отрисовки серии, константа DRAW_STYLES:
line— линия, форма задаётсяlineInterpolation. БезlineInterpolationсерия рисуется только точками.bars— узкие столбцы по центру точки X.barsLeft/barsRight— столбцы на всю ширину шага по оси X (гистограмма); различаются стороной, к которой столбец прижат относительно точки X.points— точки без соединяющей линии.
Line interpolation
lineInterpolation в useLayer — форма линии для drawStyle='line', константа LINE_INTERPOLATIONS. Для остальных drawStyle игнорируется:
linear— прямые отрезки между точками.spline— сглаженная кривая.stepAfter— ступенька: значение держится до следующей точки.stepBefore— ступенька: значение меняется сразу после предыдущей точки.
Цвет серии
color в useLayer — одно из 16 значений SERIES_COLORS: четыре оттенка (green, blue, violet, crimson) × четыре ступени насыщенности (1–4). Порядок значений в константе — рекомендуемый порядок назначения цветов сериям: сначала первая ступень всех оттенков, затем вторая и так далее. Заливка под серией — тот же цвет с прозрачностью.
Установка
pnpm add @cloud-ru/ds-uikit-product-charts
import { InteractiveChart, useLayer } from '@cloud-ru/ds-uikit-product-charts'
Примеры использования
Несколько серий
import { InteractiveChart, useLayer } from '@cloud-ru/ds-uikit-product-charts';
import { useMemo } from 'react';
type ChartProps = Parameters<typeof InteractiveChart>[0];
const WIDTH = 640;
const HEIGHT = 320;
const POINTS = 40;
const X_VALUES = Array.from({ length: POINTS }, (_, index) => index);
const DATA: ChartProps['data'] = [
X_VALUES,
X_VALUES.map(x => Math.round(50 + 30 * Math.sin(x / 5))),
X_VALUES.map(x => Math.round(40 + 20 * Math.cos(x / 7))),
X_VALUES.map(x => Math.round(20 + 10 * Math.sin(x / 3))),
];
export function MultiSeries() {
const cpu = useLayer({ label: 'CPU', color: 'blue1', drawStyle: 'line', lineInterpolation: 'spline' });
const memory = useLayer({ label: 'RAM', color: 'green1', drawStyle: 'line', lineInterpolation: 'stepAfter' });
const disk = useLayer({ label: 'Disk', color: 'violet2', drawStyle: 'bars' });
// Первая серия — ось X, остальные совпадают по порядку с массивами данных.
const options = useMemo<ChartProps['options']>(
() => ({ width: WIDTH, height: HEIGHT, series: [{}, cpu, memory, disk] }),
[cpu, memory, disk],
);
return <InteractiveChart data={DATA} options={options} />;
}Box plot
import { InteractiveChart } from '@cloud-ru/ds-uikit-product-charts';
type ChartProps = Parameters<typeof InteractiveChart>[0];
// Формат данных box plot: [x, min, q1, median, q3, max].
const DATA: ChartProps['data'] = [
[1, 2, 3, 4, 5, 6],
[10, 14, 8, 20, 12, 16],
[22, 28, 18, 34, 25, 30],
[30, 36, 26, 42, 33, 38],
[40, 46, 35, 52, 44, 49],
[55, 62, 50, 70, 58, 64],
];
const HEIGHT = 320;
const OPTIONS: ChartProps['options'] = { width: 640, height: HEIGHT };
export function BoxPlot() {
return <InteractiveChart type='boxPlot' data={DATA} options={OPTIONS} />;
}Props
Types
WithSupportProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
className | string | — | no | CSS-класс корня |
data | AlignedData | — | yes | Данные в формате uPlot: первый массив — значения оси X, остальные — серии |
data-test-id | string | — | no | |
options | Partial<Options> | — | no | Опции uPlot, которые глубоко сливаются поверх базовой конфигурации `type` |
type | "boxPlot" | "default" | default | no | Базовая конфигурация графика |
Types
WithSupportProps
Storybook
Смотри также
- HeatMapChart — матрица значений.
- PieChart — доли целого.