InteractiveChart

Обёртка над uPlot: компонент берёт базовую конфигурацию по type, подставляет в неё цвета текущей темы и глубоко сливает поверх неё options. Данные передаются в формате uPlot (AlignedData): первый массив — значения оси X, остальные — серии.

Серии описываются в options.series: первая запись относится к оси X (обычно {}), остальные совпадают по порядку с массивами данных. Хук useLayer собирает серию в цветах палитры SERIES_COLORS — цвет читается с корня графика при отрисовке, поэтому серия следует теме того графика, в котором нарисована.

Размер по умолчанию — 800×600 px, меняется через options.width / options.height. График рисуется на canvas и требует браузерного окружения.

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

  • Временные ряды и метрики мониторинга, где нужно приблизить участок графика.

  • Сравнение нескольких серий на одних осях.

  • Статистическое распределение по группам — type='boxPlot'.

  • Доли целого:

  • Матрица значений по двум категориальным осям:

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

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

Несколько серий

Несколько серийТри слоя useLayer: spline, stepAfter и столбцы
tsx
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

Box plottype='boxPlot', данные [x, min, q1, median, q3, max]; наведите курсор на группу
tsx
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

PropsWithSupportProps
PropTypeDefaultRequiredDescription
classNamestring—noCSS-класс корня
dataAlignedData—yesДанные в формате uPlot: первый массив — значения оси X, остальные — серии
data-test-idstring—no
optionsPartial<Options>—noОпции uPlot, которые глубоко сливаются поверх базовой конфигурации `type`
type"boxPlot" | "default"defaultnoБазовая конфигурация графика

Types

WithSupportProps

Storybook

Смотри также