AI助手与对话
AiAgentBadge
@mox-hub/patterns · AI · 助手与对话 · canonical
ai-agent-badge@mox-hub/patternsAI Executioncanonicalsrc/components/ai-agent-badge.tsx变体演示ai-agent-badge
AI: 小码AIAI: 小码
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| agentName* | string | — | — |
| size* | "sm" | "md" | 'sm' | — |
| labels* | Partial<AiAgentBadgeLabels> | — | — |
源码
import { Sparkles } from 'lucide-react';
import { cn } from '@mox-hub/ui';
import { usePatternLabels } from '../lib/i18n';
/** 组件内文案缺省(中文常量;消费方经 labels 覆写接入 i18n)。 */
export interface AiAgentBadgeLabels {
/** 有名同事的前缀,默认「AI:」 */
prefix: string;
/** 无名字时的兜底文案 */
fallback: string;
}
export const AI_AGENT_BADGE_DEFAULT_LABELS: AiAgentBadgeLabels = {
prefix: 'AI:',
fallback: 'AI',
};
export interface AiAgentBadgeProps {
agentName?: string | null;
size?: 'sm' | 'md';
/** 文案覆写(默认 zh-CN;英文由消费方传入 labels 切换)。 */
labels?: Partial<AiAgentBadgeLabels>;
}
export function AiAgentBadge({
agentName,
size = 'sm',
labels,
}: AiAgentBadgeProps) {
const D = usePatternLabels('aiAgentBadge', AI_AGENT_BADGE_DEFAULT_LABELS);
const text: AiAgentBadgeLabels = {
prefix: labels?.prefix ?? D.prefix,
fallback: labels?.fallback ?? D.fallback,
};
return (
<span
className={cn(
'inline-flex items-center gap-1 rounded-full bg-accent-purple-light/50 font-medium text-accent-purple',
size === 'sm' ? 'px-1.5 py-0.5 text-xs' : 'px-2 py-0.5 text-sm',
)}
>
<Sparkles className={size === 'sm' ? 'h-3 w-3' : 'h-3.5 w-3.5'} />
{agentName ? `${text.prefix} ${agentName}` : text.fallback}
</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。
用法说明
AI 同事徽标:Sparkles + AI: 名称;agentName 缺省显示 AI,size 两档。