Graphiques
Une tendance, une série, une part et une répartition. Du SVG en ligne, aucune dépendance, et jamais un point inventé.
import { BarChart, BarRows, Donut, LineChart, Sparkline } from '@hanzo/ui/product'Les graphiques se dessinent en SVG en ligne et prennent leurs couleurs dans le thème en cours, donc ils s’inversent avec lui. Ils sont honnêtes par construction : une sparkline avec moins de deux points ne rend rien, un donut sans valeur positive rend un tiret long, et aucun graphique n’invente une tendance. L’appelant passe de vraies séries.
Deux formes portent les données. Un ChartPoint est une valeur étiquetée sur
un axe séquentiel ; un Slice est une grandeur étiquetée sur un axe
catégorique, avec une couleur facultative et une piste.
type ChartPoint = { label: string; value: number }
type Slice = { label: string; value: number; color?: string; hint?: string }Sparkline
Une tendance à taille fixe pour une carte de métrique. values est un
tableau tout simple ; width, height et color sont facultatifs.
<Sparkline values={[3, 5, 4, 8, 7, 11, 9, 14]} width={160} height={40} />Graphique en ligne
Une valeur au fil du temps. Il mesure son conteneur, donc il est aussi large
que la boîte où il se trouve, et le survol lit le point le plus proche, à
côté d’une ligne de repère. formatValue met en forme la lecture.
<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`}
/>Graphique en barres
Les mêmes données, en barres. Les mêmes props.
<BarChart data={points} height={200} />Donut
Une part. La couleur est une donnée, pas un mode : une part qui a un color
est dessinée dedans, et une part qui n’en a pas prend une rampe monochrome
tirée du premier plan, donc un seul composant sert un graphique catégorique
et un graphique à la marque. center se rend à l’intérieur de l’anneau ;
legend dessine une liste intégrée d’étiquettes et de pourcentages, éteinte
par défaut pour qu’un consommateur puisse en composer une plus riche.
<Donut
slices={[
{ label: 'zen-4', value: 62 },
{ label: 'zen-3', value: 28 },
{ label: 'other', value: 10 },
]}
center="62%"
legend
/>CHART_PALETTE est les huit teintes distinctes d’une série catégorique,
réglées pour le fond sombre ; CHART_OTHER est le ton en sourdine d’un
reste.
Rangées de barres
Une répartition en barres horizontales étiquetées, dessinées avec les
primitifs de disposition pour qu’elles prennent le thème comme la coque.
Elle prend la même forme Slice.
<BarRows
bars={[
{ label: 'us-east', value: 1240 },
{ label: 'eu-west', value: 860 },
{ label: 'ap-south', value: 410 },
]}
/>Mesurer la boîte
useContainerWidth est exporté lui aussi : un ref et la largeur qu’il a
mesurée en dernier, tenue par un ResizeObserver. C’est ce qu’utilisent les
graphiques en ligne et en barres, et ce qu’un graphique à vous peut utiliser
pour dessiner dans la boîte qu’on lui donne, plutôt que dans un nombre qu’il
aurait deviné.