Gauge 仪表盘
业务组件
仪表盘 — 面向 ERP/企业场景的业务组件。
何时使用
需要仪表盘功能时使用本组件。
代码示例
基础用法
tsx
import { Gauge, RadialProgress } from "@/components/business/gauge"
export function Basic() {
return (
<div className="space-y-4">
<Gauge />
<RadialProgress />
</div>
)
}API / Props
Gauge
| Prop | Type | Default | 说明 |
|---|---|---|---|
className | string | — | 自定义样式类名 |
value | number | — | 当前值(受控) |
min | number | 0 | 最小值 |
max | number | 100 | 最大值 |
size | number | 160 | 组件尺寸 |
strokeWidth | number | 12 | |
label | React.ReactNode | — | 标签文本 |
showValue | boolean | true | |
formatValue | (...args) => unknown | — | |
variant | "default" | "success" | "warning" \... | default | 样式变体 |
| ...rest | React.ComponentProps<"div"> | — | 透传 <div> 原生属性 |
注意事项
- Client Component: 使用
"use client",依赖 React hooks/状态,需在客户端渲染。 - 原生属性: 继承所有
<div>原生 HTML 属性。
📘 完整交互式示例与控件属性请查看 Storybook 文档。