Ordo UI
组件Data Display

Meter

@mox-hub/ui 组件 · Data Display · standby

meter@mox-hub/uiData Displaystandbysrc/components/meter.tsx
变体演示meter
x

Props API

Prop类型默认值说明
className*string | ((state: MeterRootState) => string)——
children*ReactNode——

源码

packages/ui/src/components/meter.tsx
"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 /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

度量条(非进度),用 value 与 min、max 表达区间;表达任务进度请用 progress。