@hanzo/ui

图表

一条趋势、一组序列、一份份额、一种分布。内联 SVG,没有依赖,也从不编造一个点。

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

图表用内联 SVG 来画,颜色取自当下的主题,所以会跟着主题翻转。诚实是结构本身:少于两个点的迷你趋势什么都不画,没有正值的圆环画出一条全身破折号,没有一张图会发明趋势。调用者传入真实的序列。

两种形状携带数据。ChartPoint 是顺序轴上一个带标签的值;Slice 是分类轴上一个带标签的量,颜色和提示可选。

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

迷你趋势

给指标卡用的、尺寸固定的趋势。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`}
/>

柱状

同一份数据,画成柱。props 相同。

<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
/>
62%
zen-462%
zen-328%
other10%

CHART_PALETTE 是分类序列用的八个彼此不同的色相,按深色底调过;CHART_OTHER 是留给余量的那种压低的颜色。

条形行

一种分布,画成带标签的水平条,用布局原语来画,所以它跟上壳一样吃主题。接收同一种 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

测量这个盒子

useContainerWidth 也导出了:一个 ref,以及它上次量到的宽度,由 ResizeObserver 保管。折线和柱状用的就是它,你自己的图也可以用它,画进被给到的那个盒子,而不是一个猜出来的数字。