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

源码

packages/patterns/src/components/assistant-decision-tab.tsx
/**
 * 待决议卡片堆 · 缩小挂条 —— 助理面板左缘的默认伴随形态(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 /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

待决卡片堆缩小挂条:数量角标 + 阻断脉冲 + 竖排「待决卡片」;打开全屏批阅由 onOpen 注入。