Beta · 演进中

仪表盘

环形仪表盘：中心百分比，适合 KPI 完成率。

发布完成率

html

<div class="chart-grid">  <div>    <p class="chart-cap">发布完成率</p>    <div class="icen-chart" id="gauge-demo"></div>  </div></div>

特性

渲染：renderGauge；环形单值，中心显示百分比

接口

导出: renderGauge 共享行为模块，清单含族内导出
事件: icen:chart-legend-toggleicen:chart-legend-visibilityicen:chart-zoom detail 契约见 IcenEventMap；共享行为模块，清单含族内事件
类型: dist/behaviors/charts.d.mts（随 npm 包发布，含全部 JSDoc 约束）

安装

bun add @icen.ai/ui

pnpm add @icen.ai/ui

npm install @icen.ai/ui

yarn add @icen.ai/ui

一行引入该组件（CSS 与 behavior 自动带上，无需关心内部 CSS 文件名）：

import '@icen.ai/ui/kit/chart-gauge';

也可以用脚手架直接打印引入行：

bash

bunx --bun @icen.ai/ui add chart-gauge

Astro 项目注意：kit 入口里的 CSS import 在页面 <script> 里会被 Astro 的 client bundle 摇掉——请改在布局 frontmatter 里引 CSS（import '@icen.ai/ui/components/chart-gauge.css';），JS 行为仍可走 kit。Vite SPA / webpack 项目无此问题。

用法

import { renderGauge } from '@icen.ai/ui/kit/chart-gauge';renderGauge(el, { value: 64, label: '完成率' });