@hanzo/ui

Diagramme

Ein Trend, eine Serie, ein Anteil und eine Verteilung. Inline-SVG, keine Abhängigkeit, und nie ein erfundener Punkt.

import { BarChart, BarRows, Donut, LineChart, Sparkline } from '@hanzo/ui/product'

Die Diagramme zeichnen mit Inline-SVG und nehmen ihre Farben aus dem lebenden Theme, also kehren sie sich mit ihm um. Sie sind von Konstruktion her ehrlich: eine Sparkline mit weniger als zwei Punkten rendert nichts, ein Donut ohne positiven Wert rendert einen Geviertstrich, und kein Diagramm erfindet einen Trend. Aufrufer geben echte Serien hinein.

Zwei Formen tragen die Daten. Ein ChartPoint ist ein beschrifteter Wert auf einer sequenziellen Achse; ein Slice ist eine beschriftete Größe auf einer kategorialen, mit optionaler Farbe und einem Hinweis.

type ChartPoint = { label: string; value: number }
type Slice = { label: string; value: number; color?: string; hint?: string }

Sparkline

Ein Trend in fester Größe für eine Metrik-Karte. values ist ein schlichtes Array; width, height und color sind optional.

<Sparkline values={[3, 5, 4, 8, 7, 11, 9, 14]} width={160} height={40} />

Liniendiagramm

Ein Wert über die Zeit. Es misst seinen Container, ist also so breit wie die Box, in der es steht, und beim Hovern liest es den nächsten Punkt neben einer Führungslinie ab. formatValue formatiert die Ablesung.

<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`}
/>

Balkendiagramm

Dieselben Daten, als Balken. Dieselben Props.

<BarChart data={points} height={200} />

Donut

Ein Anteil. Farbe ist ein Datum, kein Modus: ein Segment mit color wird darin gezeichnet, und ein Segment ohne nimmt eine monochrome Rampe vom Vordergrund, sodass eine Komponente ein kategoriales Diagramm bedient und eines, das zur Marke passt. center rendert innerhalb des Rings; legend zeichnet eine eingebaute Liste aus Beschriftung und Prozent, standardmäßig aus, damit ein Nutzer eine reichere zusammensetzen kann.

<Donut
  slices={[
    { label: 'zen-4', value: 62 },
    { label: 'zen-3', value: 28 },
    { label: 'other', value: 10 },
  ]}
  center="62%"
  legend
/>
62%
zen-462%
zen-328%
other10%

CHART_PALETTE sind die acht unterscheidbaren Farbtöne für eine kategoriale Serie, auf den dunklen Grund abgestimmt; CHART_OTHER ist der gedämpfte Ton für einen Rest.

Balkenreihen

Eine Verteilung als beschriftete waagerechte Balken, gezeichnet mit den Layout-Primitiven, damit sie das Theme so annehmen wie die Hülle. Nimmt dieselbe Form Slice.

<BarRows
  bars={[
    { label: 'us-east', value: 1240 },
    { label: 'eu-west', value: 860 },
    { label: 'ap-south', value: 410 },
  ]}
/>
us-east
1,240
eu-west
860
ap-south
410

Die Box messen

useContainerWidth wird ebenfalls exportiert: ein ref und die Breite, die es zuletzt gemessen hat, gehalten von einem ResizeObserver. Das nutzen die Linien- und Balkendiagramme, und das kann ein eigenes Diagramm nutzen, um in die Box zu zeichnen, die es bekommt, und nicht in eine Zahl, die es geraten hat.