PatternsData Display
StatusPill
@mox-hub/patterns 模式 · Data Display · deprecated
status-pill@mox-hub/patternsData Displaydeprecatedsrc/components/status-pill.tsx变体轴
tonedefaultinfowarningsuccessdanger
变体演示status-pill
默认进行中已完成待处理失败
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| children* | ReactNode | — | — |
| tone* | Tone | "default" | — |
| className* | string | — | — |
源码
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/translatorprops,其次用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 的悬停语义。