组件Data Display
Meter
@mox-hub/ui 组件 · Data Display · standby
meter@mox-hub/uiData Displaystandbysrc/components/meter.tsx变体演示meter
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| className* | string | ((state: MeterRootState) => string) | — | — |
| children* | ReactNode | — | — |
源码
"use client"
import { Meter as MeterPrimitive } from "@base-ui/react/meter"
import type React from "react"
import { cn } from "../lib/utils"
/* coss ui Meter(base-ui 配方移植,registry @coss/meter)— 有界量程表 */
export function Meter({
className,
children,
...props
}: MeterPrimitive.Root.Props): React.ReactElement {
return (
<MeterPrimitive.Root
data-slot="meter"
className={cn("flex w-full flex-col gap-2", className)}
{...props}
>
{children ? (
children
) : (
<MeterTrack>
<MeterIndicator />
</MeterTrack>
)}
</MeterPrimitive.Root>
)
}
export function MeterLabel({
className,
...props
}: MeterPrimitive.Label.Props): React.ReactElement {
return (
<MeterPrimitive.Label
className={cn("font-medium text-foreground text-sm", className)}
data-slot="meter-label"
{...props}
/>
)
}
export function MeterTrack({
className,
...props
}: MeterPrimitive.Track.Props): React.ReactElement {
return (
<MeterPrimitive.Track
className={cn(
// P3-10:与 Progress 共用轨道配方(h-1.5 + rounded-full + bg-muted)
"block h-1.5 w-full overflow-hidden rounded-full bg-muted",
className
)}
data-slot="meter-track"
{...props}
/>
)
}
export function MeterIndicator({
className,
...props
}: MeterPrimitive.Indicator.Props): React.ReactElement {
return (
<MeterPrimitive.Indicator
className={cn("bg-primary transition-[width] duration-normal", className)}
data-slot="meter-indicator"
{...props}
/>
)
}
export function MeterValue({
className,
...props
}: MeterPrimitive.Value.Props): React.ReactElement {
return (
<MeterPrimitive.Value
className={cn("text-foreground text-sm tabular-nums", className)}
data-slot="meter-value"
{...props}
/>
)
}
export { MeterPrimitive }
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
度量条(非进度),用 value 与 min、max 表达区间;表达任务进度请用 progress。