HeatMapChart

Тепловая карта матрицы data (строки × столбцы). Цвет ячейки вычисляется линейной шкалой по диапазону options.domain, цвет текста в ячейке подбирается по контрасту с фоном. Под сеткой — градиентная легенда с пятью делениями.

Высота карточки задаётся options.height в px (по умолчанию 700); строки сетки делят свободную высоту поровну.

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

  • Распределение значения по двум категориальным осям: загрузка по дням и часам, метрика по узлам кластера.

  • Поиск аномалий и пиков в большой матрице, где точные значения вторичны.

  • Динамика одного-двух рядов во времени:

  • ✅ Задавайте domain по реальному диапазону метрики (например, [0, 100] для процентов).

  • ❌ Вычислять domain из текущих данных, если карты нужно сравнивать между собой — шкала будет разной.

  • ✅ Передавайте ticks для обеих осей — без подписей строки и столбцы не читаются.

  • ❌ Передавать ticks, длина которых не совпадает с числом столбцов или строк data.

  • ✅ Форматируйте значения через formatter (единицы, округление).

  • ❌ Округлять значения в data ради отображения — domain и цвет считаются по исходным значениям.

  • ✅ Отключайте легенду (legend.show: false), только если шкала объяснена рядом с картой.

  • ❌ Выводить длинный текст в ячейку через cellRender — ячейка не растёт по контенту.

Анатомия

  • Заголовок options.title.
  • Подпись оси X axes.xAxis.label — над или под сеткой, вместе с делениями.
  • Подпись оси Y axes.yAxis.label — слева, повёрнута вертикально.
  • Сетка ячеек с делениями axes.xAxis.ticks / axes.yAxis.ticks.
  • Легенда — градиентная полоса от начала до конца шкалы и пять делений по domain.

X axis position (default bottom)

axes.xAxis.position определяет, с какой стороны сетки выводятся деления и подпись оси X; значение выставляется на корень атрибутом data-x-axis-position. Значения — константа X_AXIS_POSITION (также доступна как статика HeatMapChart.xAxisPositions):

  • bottom — под сеткой, как в обычном графике.
  • top — над сеткой. Подходит для высокой карты: подписи столбцов видны без прокрутки.

Legend (default show: true)

legend.show включает градиентную легенду под сеткой:

  • true — полоса цветовой шкалы и пять делений по domain.
  • false — легенда скрыта, сетка занимает освободившуюся высоту.

Ячейка

По умолчанию ячейка показывает значение, отформатированное formatter. cellRender(x, y, value) заменяет содержимое ячейки целиком, фон ячейки по-прежнему задаётся шкалой. Inline-стили подписей и ячеек переопределяются через options.styles.

Установка

pnpm add @cloud-ru/ds-uikit-product-charts
import { HeatMapChart } from '@cloud-ru/ds-uikit-product-charts'

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

Кастомная ячейка

Кастомная ячейкаformatter добавляет единицы, cellRender выделяет значения от 80%, ось X сверху

Загрузка CPU

Время
День недели
Пн
Вт
Ср
Чт
Пт
00:00
04:00
08:00
12:00
16:00
20:00
0%
85%
70%
55%
40%
25%
55%
40%
25%
10%
95%
80%
10%
95%
80%
65%
50%
35%
65%
50%
35%
20%
5%
90%
20%
5%
90%
75%
60%
45%
tsx
import { HeatMapChart } from '@cloud-ru/ds-uikit-product-charts';

const DAYS = ['Пн', 'Вт', 'Ср', 'Чт', 'Пт'];
const HOURS = ['00:00', '04:00', '08:00', '12:00', '16:00', '20:00'];

// Загрузка CPU в процентах: строки — дни, столбцы — часы.
const DATA = DAYS.map((_, day) => HOURS.map((__, hour) => ((day * 11 + hour * 17) % 20) * 5));

function formatPercent(value: number) {
  return `${value}%`;
}

function renderCell(_x: number, _y: number, value: number) {
  return value >= 80 ? <strong>{formatPercent(value)}</strong> : formatPercent(value);
}

export function CustomCell() {
  return (
    <HeatMapChart
      data={DATA}
      options={{
        title: 'Загрузка CPU',
        height: 420,
        domain: [0, 100],
        formatter: formatPercent,
        cellRender: renderCell,
        axes: {
          xAxis: { label: 'Время', ticks: HOURS, position: 'top' },
          yAxis: { label: 'День недели', ticks: DAYS },
        },
      }}
    />
  );
}

Props

Types

PropsWithSupportProps
PropTypeDefaultRequiredDescription
classNamestring—noCSS-класс корня
datanumber[][]—yesМатрица значений: строки × столбцы
data-test-idstring—no
optionsHeatMapChartOptions—yesНастройки отображения

Types

WithSupportProps

Storybook

Смотри также

  • InteractiveChart — временные ряды и распределения.