PatternsSemantic
SubtaskBadge
@mox-hub/patterns 模式 · Semantic · canonical
subtask-badge@mox-hub/patternsSemanticcanonicalsrc/components/subtask-badge.tsx变体演示subtask-badge
2/55/50/3
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| done* | number | — | — |
| total* | number | — | — |
源码
/**
* SubtaskBadge - 子任务进度徽章(Task Atoms 套件 · 22px 外框标准)
*
* 行尾「进度环 + 计数」胶囊:左侧进度环与左/上/下边框等距贴合
* (环 18px,四周间隙统一 2px = ps-0.5 + 垂直居中余量),右侧计数放大至 text-xs。
* 提取自 task-rows / task-simple-list / 设计系统画廊的三份重复实现(2026-09-29)。
*
* props 面封闭(G8):不接 className,形态由组件基线负责。
*/
import { cn } from '@mox-hub/ui';
function ProgressRing({ done, total }: { done: number; total: number }) {
const size = 18;
const r = (size - 2.75) / 2;
const circ = 2 * Math.PI * r;
const ratio = total > 0 ? done / total : 0;
const stroke =
ratio === 1
? 'hsl(var(--accent-green))'
: ratio > 0
? 'hsl(var(--accent-blue))'
: 'hsl(var(--muted-foreground))';
return (
<svg width={size} height={size} viewBox={`0 0 ${size} ${size}`} className="shrink-0 -rotate-90">
<circle cx={size / 2} cy={size / 2} r={r} fill="none" stroke="currentColor" strokeWidth="2.5" className="text-muted-foreground/20" />
<circle
cx={size / 2}
cy={size / 2}
r={r}
fill="none"
stroke={stroke}
strokeWidth="2.75"
strokeDasharray={`${ratio * circ} ${circ}`}
strokeLinecap="round"
/>
</svg>
);
}
export function SubtaskBadge({ done, total }: { done: number; total: number }) {
return (
<span
title={`子任务 ${done}/${total}`}
className={cn(
'inline-flex shrink-0 items-center gap-1.5 h-5.5 ps-0.5 pe-2 ms-1.5',
'rounded-full border border-border/80 bg-muted/50 font-mono font-medium text-muted-foreground',
)}
>
<ProgressRing done={done} total={total} />
<span className="text-xs">{done}/{total}</span>
</span>
);
}
可访问性与 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。
用法说明
子任务进度徽章:进度环 + done/total 计数,22px 外框标准;纯展示、props 封闭。