BarChart

分组与堆叠柱状图,柱体纤细,顶部 4px 圆角,堆叠段之间留 2px 间隙;排名时使用横向柱状图。

查看源码
  • 输入
  • 缓存读取
  • 输出
  • 推理
Tokens by kind per day
类别输入缓存读取输出推理
Oct 684万71.3万56万38.3万
Oct 7126万104.5万80.5万31.5万
Oct 8108万90.3万70万47.3万
Oct 990万76万59.5万40.5万
Oct 10132万109.3万49万33.8万
Oct 11114万95万73.5万49.5万
Oct 1296万80.8万63万42.8万
import { BarChart } from "@logicplanes/kaeso-ui";

属性

  • aria-label
    string

    图表的无障碍名称(“按模型统计的请求”)。

  • axisLabels
    string[]

    柱体下方较短的名称,每个类别一个(“8月3日”代表“8月3日当周”);提示框、表格和屏幕阅读器仍使用完整类别。在新的一年开始处标出年份(“8月”“12月”“2026”“2月”),并传入 dates:标签放不下时,坐标轴每隔 n 个保留一个,并保留最新值之前的那个(axisLabelIndexes)。

  • categories
    string[]

    沿分类轴排列的名称,每个柱组一个,按顺序排列。它们也作为提示框和数据表的标题。

  • dates
    readonly AxisDate[]

    每个类别开始的日期,每个类别一个:Date 或 ISO 日期(“2026-01-05”)。坐标轴精简标签时,会根据这些日期保留新一年开始处的标签(12 月之后的月份、1 月的第一周),从而在所有语言中保留相同的标签。

  • empty
    boolean

    以空状态(emptyText)替代数据。当时间段内没有数据时传入。

  • emptyText
    ReactNode

    空状态显示的文字。默认为 LocaleProvider 语言中的“此时间段内没有数据”。

  • error
    ReactNode

    数据加载失败:图表保持高度,低调地说明情况并提供“重试”。错误以 toast 显示,因此不会显示该值;请在请求失败处用 toast 显示消息。

  • formatValue
    ((v: number) => string) = (v) => formatNumber(v)

    格式化坐标轴和提示框中的值。

  • height
    number = 240

    绘图区高度,单位 px(默认 240)。

  • highlight
    number

    像指针悬停一样高亮某个类别并显示提示框:用于联动视图或状态页面。

  • layout
    "horizontal" | "grouped" | "stacked" = grouped

    grouped 将每个分类的柱并排显示(默认),stacked 将其堆叠,horizontal 横向绘制柱,用于排名。

  • loading
    boolean

    数据正在加载:图表保持高度,并显示一条低调的加载条。

  • onRetry
    (() => void)

    出现 error 后点击“重试”时调用;不传入时不显示该按钮。

  • series
    BarSeries[]

    柱状图的系列,每个包含 id、label、每个分类一个值以及可选的 color。未指定时,颜色按 id 依系列顺序分配。