Ordo UI
AI助手与对话

AssistantQuickPrompts

@mox-hub/patterns · AI · 助手与对话 · canonical

assistant-quick-prompts@mox-hub/patternsAI Executioncanonicalsrc/components/assistant-quick-prompts.tsx
变体演示assistant-quick-prompts

Props API

Prop类型默认值说明
onSend*(content: string) => void——
disabled*boolean——
aiPrompts*string[]——
labels*Partial<AssistantQuickPromptsLabels>——

源码

packages/patterns/src/components/assistant-quick-prompts.tsx
/**
 * 快捷问法 chips —— 打字永远是可选项;点选即发送。
 * 静默 AI 场景 quick-prompts 可用时展示个性化问法(Sparkles 标识),
 * 失败/空回落静态兜底三条。
 */
import { Sparkles } from 'lucide-react'
import { Button } from '@mox-hub/ui/components/button'
import { usePatternLabels } from '../lib/i18n'

/** 组件内文案缺省(中文常量;消费方经 labels 覆写接入 i18n)。 */
export interface AssistantQuickPromptsLabels {
  prompt1: string
  prompt2: string
  prompt3: string
}

export const ASSISTANT_QUICK_PROMPTS_DEFAULT_LABELS: AssistantQuickPromptsLabels = {
  prompt1: '总结一下项目现状',
  prompt2: '本周有什么风险?',
  prompt3: '有什么需要我现在决定的?',
}

export function AssistantQuickPrompts({
  onSend,
  disabled,
  aiPrompts,
  labels,
}: {
  onSend: (content: string) => void
  disabled?: boolean
  /** 静默 AI 生成的个性化问法(空/undefined 时回落静态) */
  aiPrompts?: string[]
  /** 文案覆写(默认 zh-CN;主仓 i18n 适配层集中传入 t() 结果)。 */
  labels?: Partial<AssistantQuickPromptsLabels>
}) {
  const D = usePatternLabels(
    'assistantQuickPrompts',
    ASSISTANT_QUICK_PROMPTS_DEFAULT_LABELS,
  )
  const staticPrompts = [
    labels?.prompt1 ?? D.prompt1,
    labels?.prompt2 ?? D.prompt2,
    labels?.prompt3 ?? D.prompt3,
  ]
  const prompts = aiPrompts && aiPrompts.length > 0 ? aiPrompts : staticPrompts
  const fromAi = aiPrompts && aiPrompts.length > 0

  return (
    <div
      className="flex flex-wrap gap-1.5"
      data-ai-component="assistant.quick-prompts"
      data-source={fromAi ? 'ai' : 'static'}
    >
      {fromAi ? (
        <span className="flex items-center text-2xs text-accent-purple" aria-hidden="true">
          <Sparkles className="size-3" />
        </span>
      ) : null}
      {prompts.map((prompt) => (
        <Button
          key={prompt}
          type="button"
          variant="outline"
          disabled={disabled}
          onClick={() => onSend(prompt)}
          className="h-6 rounded-full px-2.5 text-2xs font-normal text-content-text-secondary"
        >
          {prompt}
        </Button>
      ))}
    </div>
  )
}

可访问性与 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。

用法说明

快捷问法 chips:aiPrompts 为空回落三条静态兜底;labels 覆写,点击即发送。