PatternsData Display
StatTile
@mox-hub/patterns 模式 · Data Display · canonical
stat-tile@mox-hub/patternsData Displaycanonicalsrc/components/stat-tile.tsx变体演示stat-tile
任务
12
成本
$0.42
本周累计
执行
38
通过率
92%
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| label* | ReactNode | — | — |
| value* | ReactNode | — | — |
| hint* | ReactNode | — | — |
| icon* | ReactNode | — | — |
源码
import type * as React from "react"
/**
* StatTile —— mini 统计块(G 类 semantic 批二)
*
* 弹窗 / 面板内「灰底 + 小标签 + 大数值」mini 统计块的唯一实现,抽象自
* dashboard-page 下钻弹窗内原本地 StatTile(7 个弹窗 14 实例)及 team-stats-section
* 等同类 tile。
*
* **形态照抄 dashboard-page 本地 StatTile 现有 class(等价 bar:几何/颜色一致)**:
* 根 `bg-muted/50 rounded-lg p-3`,label `text-xs text-muted-foreground`,value
* `text-2xl font-semibold mt-1`。原实现经 className 透传给 value 上语义色(如
* text-accent-purple)——semantic 层 props 封闭后不设样式口子,语义色由调用方
* 以 ReactNode 包 span 注入:`value={<span className="text-accent-purple">{v}</span>}`,
* 渲染结果与原 p 直接着色一致(色沿文本继承,零形态差)。
*
* **props 面封闭(裁决 G8,同 chip.tsx)**:不接 `className`、不透传 variant、
* 不 extends HTMLAttributes。icon 取 `React.ReactNode` 而非 LucideIcon——首消费
* dashboard-page 的 tile 形态无 icon 先例,无证据支持组件级图标档,与 chip 同口径
* 留节点槽位即可;hint 为数值下方补充说明(现用形态暂无实例,留标准槽位)。
*/
function StatTile({
label,
value,
hint,
icon,
}: {
/** 数值上方小标签(text-xs text-muted-foreground 基线) */
label: React.ReactNode
/** 主数值(text-2xl font-semibold mt-1 基线;语义色由调用方包 span 注入) */
value: React.ReactNode
/** 数值下方补充说明 */
hint?: React.ReactNode
/** 标签前缀图标节点(size 档由调用方给,基线 size-3.5) */
icon?: React.ReactNode
}) {
return (
<div data-slot="stat-tile" className="bg-muted/50 rounded-lg p-3">
<p className="flex items-center gap-1.5 text-xs text-muted-foreground">
{icon}
{label}
</p>
<p className="mt-1 text-xl font-semibold font-mono tabular-nums leading-tight">{value}</p>
{hint != null && <p className="mt-1 text-xs text-muted-foreground">{hint}</p>}
</div>
)
}
export { StatTile }
可访问性与 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。
用法说明
mini 统计块:灰底 + 小标签 + 大数值 + 可选 hint/icon;语义色由调用方以 ReactNode 包 span 注入。