Ordo UI
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——

源码

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

用法说明

子任务进度徽章:进度环 + done/total 计数,22px 外框标准;纯展示、props 封闭。