Meter
用于存储用量等已知范围内的测量值。进行中任务的完成程度使用 Progress。
预览
存储空间用量
用标签、数值和填充轨道展示总量 100 GB 中已使用的 64 GB。
正在加载预览。
安装
首次使用此 Registry?请先完成 基础配置与共享样式安装 。
npx shadcn@latest add @neumorphism-ui/meter先安装一次共享 base,然后使用 CLI 添加组件及其依赖。
用法
设置值与范围,并组合 MeterLabel、MeterValue、MeterTrack 和 MeterIndicator。百分比含义不明确时,补充单位或上下文。
"use client";
import { Meter, MeterIndicator, MeterLabel, MeterTrack, MeterValue } from "@/components/ui/meter";
export default function Example() {
return (
<Meter value={64} max={100}>
<MeterLabel>Storage used</MeterLabel>
<MeterValue />
<MeterTrack><MeterIndicator /></MeterTrack>
</Meter>
);
}API 参考
在已知范围内表示测量值的计量条。 任务完成进度请用 Progress。配合 MeterLabel 显示可见数值。
| 组件 | 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
Meter | value | number | — | 范围内的当前测量值。 |
Meter | min / max | number | — | 设置最小值与最大值。 |
Meter | format | Intl.NumberFormatOptions | — | 配置本地化数字格式。 |
无障碍
- 01
任务完成进度请用 Progress。配合 MeterLabel 显示可见数值。
- 02
修改 render 或 className 时保留标签关联和可见焦点。