AI助手与对话
AssistantDecisionTab
@mox-hub/patterns · AI · 助手与对话 · canonical
assistant-decision-tab@mox-hub/patternsAI Executioncanonicalsrc/components/assistant-decision-tab.tsx变体演示assistant-decision-tab
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| count* | number | — | — |
| hasBlocking* | boolean | — | — |
| onOpen* | () => void | — | — |
| labels* | AssistantDecisionTabLabels | — | — |
源码
/**
* 待决议卡片堆 · 缩小挂条 —— 助理面板左缘的默认伴随形态(2026-10-02 裁决:
* 取消「展开后左侧栏卡片堆」形态,挂条常驻缩小呈现,点击改开全屏遮罩集中批阅,
* 见 shared/decision-card/decision-review-modal)。
* 立体叠边视觉复用 decision-card.css 的 .decision-deck-collapsed-tab。
*/
import { Layers, Maximize2 } from 'lucide-react';
import { cn } from '@mox-hub/ui';
import { usePatternLabels } from '../lib/i18n';
export interface AssistantDecisionTabLabels {
/** 竖排标签;默认「待决卡片」 */
tab?: string;
/** 按钮 title;默认包含总数与紧急阻断 */
title?: (count: number, hasBlocking: boolean) => string;
}
export interface AssistantDecisionTabProps {
/** 待决议总数(角标) */
count: number;
/** 是否含紧急阻断项(角标转红 + 脉冲) */
hasBlocking: boolean;
/** 点击 → 打开全屏集中批阅遮罩 */
onOpen: () => void;
/** 文案覆写;默认 zh-CN */
labels?: AssistantDecisionTabLabels;
}
const DEFAULT_LABELS: AssistantDecisionTabLabels = {
tab: '待决卡片',
title: (total, blocking) =>
`打开全屏批阅待决卡片(共 ${total} 项${blocking ? ',含紧急阻断' : ''})`,
};
export function AssistantDecisionTab({
count,
hasBlocking,
onOpen,
labels,
}: AssistantDecisionTabProps) {
const D = usePatternLabels('assistantDecisionTab', DEFAULT_LABELS);
const L = { ...D, ...labels };
return (
<div className="flex flex-col justify-center shrink-0 z-dropdown">
<button
type="button"
onClick={onOpen}
className="decision-deck-collapsed-tab group flex flex-col items-center justify-between w-11 py-3.5 rounded-xl border border-border/80 bg-background/95 backdrop-blur-xl text-foreground cursor-pointer transition-transform active:scale-95"
title={L.title(count, hasBlocking)}
data-ai-action="assistant.decision.tab.click"
>
{/* 顶部:立体层叠卡片图标 */}
<div className="flex size-7 items-center justify-center rounded-lg bg-accent-purple-light text-accent-purple shadow-xs group-hover:scale-110 transition-transform">
<Layers className="size-4" />
</div>
{/* 中间:数量角标与竖排文字 */}
<div className="my-2.5 flex flex-col items-center gap-2">
<span
className={cn(
'flex size-5 items-center justify-center rounded-full text-3xs font-semibold tabular-nums shadow-xs',
hasBlocking
? 'bg-accent-red text-primary-foreground animate-pulse'
: 'bg-accent-purple text-primary-foreground',
)}
>
{count}
</span>
{/* 竖排精致文字:「待 决 卡 片」 */}
<span className="vertical-writing-mode text-2xs font-medium tracking-widest text-muted-foreground group-hover:text-foreground transition-colors select-none py-1">
{L.tab}
</span>
</div>
{/* 底部:全屏批阅入口提示 */}
<div className="mt-1 flex items-center justify-center text-muted-foreground group-hover:text-accent-purple transition-colors">
<Maximize2 className="size-3.5" />
</div>
</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。
用法说明
待决卡片堆缩小挂条:数量角标 + 阻断脉冲 + 竖排「待决卡片」;打开全屏批阅由 onOpen 注入。