Gráficos
Una tendencia, una serie, un reparto y una distribución. SVG en línea, sin dependencia, y jamás un punto inventado.
import { BarChart, BarRows, Donut, LineChart, Sparkline } from '@hanzo/ui/product'Los gráficos se dibujan con SVG en línea y toman los colores del tema en vivo, así que se invierten con él. Son honestos por construcción: una sparkline con menos de dos puntos no pinta nada, un donut sin ningún valor positivo pinta una raya, y ningún gráfico se inventa una tendencia. Quien llama pasa series de verdad.
Dos formas llevan los datos. Un ChartPoint es un valor con etiqueta en un
eje secuencial; un Slice es una magnitud con etiqueta en uno categórico, con
un color opcional y una pista.
type ChartPoint = { label: string; value: number }
type Slice = { label: string; value: number; color?: string; hint?: string }Sparkline
Una tendencia de tamaño fijo para una tarjeta de métrica. values es un array
a secas; width, height y color son opcionales.
<Sparkline values={[3, 5, 4, 8, 7, 11, 9, 14]} width={160} height={40} />Gráfico de líneas
Un valor a lo largo del tiempo. Mide su contenedor, así que es tan ancho como
la caja en la que está, y al pasar el cursor se lee el punto más cercano,
junto a una línea de guía. formatValue da formato a lo que se lee.
<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`}
/>Gráfico de barras
Los mismos datos, en barras. Las mismas props.
<BarChart data={points} height={200} />Donut
Un reparto. El color es un dato, no un modo: una porción con color se pinta
en ese color, y una porción sin él toma una rampa monocroma sacada del primer
plano, así que un solo componente sirve para un gráfico categórico y para uno
que va con la marca. center se pinta dentro del anillo; legend dibuja una
lista propia de etiquetas y porcentajes, apagada por defecto para que quien lo
use pueda componer una más rica.
<Donut
slices={[
{ label: 'zen-4', value: 62 },
{ label: 'zen-3', value: 28 },
{ label: 'other', value: 10 },
]}
center="62%"
legend
/>CHART_PALETTE son los ocho tonos distintos de una serie categórica,
ajustados al fondo oscuro; CHART_OTHER es el tono apagado de un resto.
Filas de barras
Una distribución en barras horizontales con etiqueta, dibujadas con los
primitivos de disposición para que cojan el tema igual que la cáscara. Toma la
misma forma Slice.
<BarRows
bars={[
{ label: 'us-east', value: 1240 },
{ label: 'eu-west', value: 860 },
{ label: 'ap-south', value: 410 },
]}
/>Medir la caja
useContainerWidth también se exporta: un ref y el ancho que midió la
última vez, sostenido por un ResizeObserver. Es lo que usan los gráficos de
líneas y de barras, y lo que puede usar un gráfico tuyo para dibujar en la
caja que se le da, y no en un número que haya supuesto.