AI助手与对话
AssistantFab
@mox-hub/patterns · AI · 助手与对话 · canonical
assistant-fab@mox-hub/patternsAI Executioncanonicalsrc/components/assistant-fab.tsx变体演示assistant-fab
对话面板内容(由消费方注入)
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| open* | boolean | — | — |
| expanded* | boolean | — | — |
| label* | string | — | — |
| children* | ReactNode | — | — |
| className* | string | — | — |
源码
/**
* AI 助理浮窗外壳 —— 右下角/底部居中的固定窗口容器。
*
* 库内只负责形态与开合显隐;store 状态、点击外部关闭、ESC 分层拦截、
* 面板内容(AssistantPanel)全部由消费方注入。
*/
import type { ReactNode } from 'react'
import { cn } from '@mox-hub/ui'
export interface AssistantFabShellProps {
/** 是否打开(关闭时 hidden + 不接收指针) */
open: boolean
/** 放大态 ≈ 屏幕 1/4;默认 380×560 固定 */
expanded: boolean
/** 无障碍名(通常为 AI 同事名) */
label: string
children: ReactNode
className?: string
}
export function AssistantFabShell({
open,
expanded,
label,
children,
className,
}: AssistantFabShellProps) {
return (
<div
role="dialog"
aria-label={label}
className={cn(
'fixed bottom-28 left-1/2 -translate-x-1/2 z-modal pointer-events-auto transition-[transform,opacity,box-shadow] duration-normal',
expanded
? 'h-dialog-scroll w-[min(96vw,1000px)]'
: 'h-[560px] w-auto max-w-[calc(100vw-2rem)]',
!open && 'pointer-events-none hidden',
className,
)}
data-ai-component="assistant.fab-window"
>
{children}
</div>
)
}
/** 与原组件同名出口:props 驱动版本(store/ESC/点击外部逻辑留主仓适配层)。 */
export function AssistantFab({
open,
expanded,
label,
children,
className,
}: AssistantFabShellProps) {
return (
<AssistantFabShell open={open} expanded={expanded} label={label} className={className}>
{children}
</AssistantFabShell>
)
}
可访问性与 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 助理浮窗外壳:fixed 定位 + 展开/收起尺寸 + 开合显隐;面板内容与 store/ESC/点击外部关闭由消费方注入。