Ordo UI
PatternsData Display

StatusPill

@mox-hub/patterns 模式 · Data Display · deprecated

status-pill@mox-hub/patternsData Displaydeprecatedsrc/components/status-pill.tsx

变体轴

tone
defaultinfowarningsuccessdanger
变体演示status-pill
默认进行中已完成待处理失败

Props API

Prop类型默认值说明
children*ReactNode——
tone*Tone"default"—
className*string——

源码

packages/patterns/src/components/status-pill.tsx
import type { ReactNode } from "react";
import { TONE_CLASS, type Tone } from "@mox-hub/ui/components/tone";
import { cn } from "@mox-hub/ui";

interface StatusPillProps {
  children: ReactNode;
  tone?: Tone;
  className?: string;
}

/**
 * StatusPill —— 状态胶囊(语义层)。
 *
 * 纯展示 span:tone 五档语义色 + 文本。状态不得只靠颜色传达(§8.5 #4),
 * 调用方必须把状态文字放进 children。外层布局微调走 className。
 *
 * @deprecated 新代码请用 `Chip`(标签/胶囊唯一实现)或 `Badge`;
 * 本件仅保留兼容到 2027-06-30。迁移:
 * `<StatusPill tone="success">已完成</StatusPill>` →
 * `<Chip tone="success" shape="pill">已完成</Chip>`(chip 补 status tone 后)。
 */
export function StatusPill({ children, tone = "default", className }: StatusPillProps) {
  return (
    <span
      className={cn(
        "inline-flex h-5 items-center rounded-full px-2 py-0.5 text-xs font-semibold",
        TONE_CLASS[tone].light,
        className,
      )}
    >
      {children}
    </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。

用法说明

已弃用(2027-06-30 到期):新代码用 Chip variant="status" 或 Badge;Chip 的 status 变体复用同一套 tone 浅底,迁移见组件页。

弃用与迁移(2027-06-30 到期)

StatusPill 已弃用,新代码请统一用 Chip 的 status 变体(同一套 tone 浅底)或 Badge:

// before
<StatusPill tone="success">已完成</StatusPill>

// after
<Chip variant="status" tone="success">已完成</Chip>

Chip 现在支持 default / info / warning / success / danger / primary 六档 tone; status 变体为静态胶囊,outline 变体保留原有可交互 chip 的悬停语义。