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

源码

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

用法说明

AI 同事徽标:Sparkles + AI: 名称;agentName 缺省显示 AI,size 两档。