Ordo UI
组件Data Display

IconMetric

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

icon-metric@mox-hub/uiData Displaycanonicalsrc/components/icon-metric.tsx
变体演示icon-metric
活跃用户1,284
本周搜索3,602

Props API

Prop类型默认值说明
icon*ReactNode——
label*ReactNode——
value*ReactNode——
className*string——

源码

packages/ui/src/components/icon-metric.tsx
import type { ReactNode } from "react";
import { cn } from "../lib/utils";

interface IconMetricProps {
  icon: ReactNode;
  label: ReactNode;
  value: ReactNode;
  className?: string;
}

export function IconMetric({ icon, label, value, className }: IconMetricProps) {
  return (
    <div
      data-slot="icon-metric"
      className={cn(
        "flex items-center gap-3 rounded-lg border border-border bg-background px-4 py-3",
        className
      )}
    >
      <div
        data-slot="icon-metric-icon"
        className="flex size-8 items-center justify-center rounded-md bg-muted/50 text-accent-blue"
      >
        {icon}
      </div>
      <div className="flex flex-col">
        <span
          data-slot="icon-metric-label"
          className="text-xs font-medium text-muted-foreground"
        >
          {label}
        </span>
        <span
          data-slot="icon-metric-value"
          className="text-sm font-semibold text-foreground tabular-nums"
        >
          {value}
        </span>
      </div>
    </div>
  );
}

可访问性与 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。

用法说明

图标加数值加标签的指标卡;仪表盘 KPI 行使用,数字建议等宽字体。