HeatMapChart
Тепловая карта матрицы data (строки × столбцы). Цвет ячейки вычисляется линейной шкалой по диапазону options.domain, цвет текста в ячейке подбирается по контрасту с фоном. Под сеткой — градиентная легенда с пятью делениями.
Высота карточки задаётся options.height в px (по умолчанию 700); строки сетки делят свободную высоту поровну.
Когда использовать
-
Распределение значения по двум категориальным осям: загрузка по дням и часам, метрика по узлам кластера.
-
Поиск аномалий и пиков в большой матрице, где точные значения вторичны.
-
Динамика одного-двух рядов во времени:
- используйте
InteractiveChart.
- используйте
-
✅ Задавайте
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'
Примеры использования
Кастомная ячейка
Загрузка CPU
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
WithSupportProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
className | string | — | no | CSS-класс корня |
data | number[][] | — | yes | Матрица значений: строки × столбцы |
data-test-id | string | — | no | |
options | HeatMapChartOptions | — | yes | Настройки отображения |
Types
WithSupportProps
Storybook
Смотри также
- InteractiveChart — временные ряды и распределения.