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

源码

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

用法说明

AI 助理浮窗外壳:fixed 定位 + 展开/收起尺寸 + 开合显隐;面板内容与 store/ESC/点击外部关闭由消费方注入。