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> | — | — |
源码
/**
* 快捷问法 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/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
快捷问法 chips:aiPrompts 为空回落三条静态兜底;labels 覆写,点击即发送。