Графики
Тренд, ряд, доля и распределение. Встроенный SVG, ни одной зависимости и ни одной выдуманной точки.
import { BarChart, BarRows, Donut, LineChart, Sparkline } from '@hanzo/ui/product'Графики рисуются встроенным SVG и берут цвета из живой темы, поэтому инвертируются вместе с ней. Они честны по построению: sparkline меньше чем с двумя точками не рисует ничего, кольцо без положительного значения рисует длинное тире, и ни один график не выдумывает тренд. Вызывающий передаёт настоящие ряды.
Данные несут две формы. ChartPoint — подписанное значение на последовательной оси; Slice — подписанная величина на категориальной, с необязательным цветом и подсказкой.
type ChartPoint = { label: string; value: number }
type Slice = { label: string; value: number; color?: string; hint?: string }Sparkline
Тренд фиксированного размера для карточки метрики. values — простой массив; width, height и color необязательны.
<Sparkline values={[3, 5, 4, 8, 7, 11, 9, 14]} width={160} height={40} />Линейный график
Значение во времени. Он меряет контейнер, поэтому шириной равен коробке, в которой сидит, а наведение читает ближайшую точку рядом с направляющей. formatValue форматирует показание.
<LineChart
data={[
{ label: 'Mon', value: 120 },
{ label: 'Tue', value: 180 },
{ label: 'Wed', value: 150 },
{ label: 'Thu', value: 260 },
{ label: 'Fri', value: 230 },
{ label: 'Sat', value: 310 },
{ label: 'Sun', value: 290 },
]}
height={200}
formatValue={(v) => `${v} req`}
/>Столбчатый график
Те же данные, столбцами. Те же пропы.
<BarChart data={points} height={200} />Кольцо
Доля. Цвет — это данные, а не режим: сектор с color рисуется им, а сектор без цвета берёт монохромную шкалу от переднего плана, так что один компонент служит и категориальному графику, и графику в бренде. center рендерится внутри кольца; legend рисует встроенный список подписи и процента и выключена по умолчанию, чтобы потребитель мог собрать список богаче.
<Donut
slices={[
{ label: 'zen-4', value: 62 },
{ label: 'zen-3', value: 28 },
{ label: 'other', value: 10 },
]}
center="62%"
legend
/>CHART_PALETTE — восемь различимых оттенков для категориального ряда, настроенных под тёмный фон; CHART_OTHER — приглушённый тон остатка.
Ряды столбцов
Распределение подписанными горизонтальными столбцами, нарисованными примитивами раскладки, чтобы тема шла как у оболочки. Принимает ту же форму Slice.
<BarRows
bars={[
{ label: 'us-east', value: 1240 },
{ label: 'eu-west', value: 860 },
{ label: 'ap-south', value: 410 },
]}
/>Измерить коробку
Экспортируется и useContainerWidth: ref и ширина, которую он измерил в последний раз, её держит ResizeObserver. Им пользуются линейный и столбчатый графики, и им может воспользоваться ваш график, чтобы рисовать в данную ему коробку, а не в число, которое он угадал.