Ordo UI
组件Overlays

MenuSurface

@mox-hub/ui 组件 · Overlays · canonical

menu-surface@mox-hub/uiOverlayscanonicalsrc/components/menu-surface.ts
变体演示menu-surface
demo 待补(demos map 未注册)

Props API

未解析到 Props(内部组件或纯静态导出,以源码为准)。

源码

packages/ui/src/components/menu-surface.ts
import {
  SURFACE_MENU_CLASS,
  menuItemVariants,
  menuLabelVariants,
  menuSeparatorVariants,
} from "./menu-styles"

/**
 * 轻量菜单表面:供 AnchoredMenu / filter-chips / toolbar-row 等自定义浮层复用。
 * 与 `menu.tsx` 共用 surface token 和条目配方(审计 P1-02 / P1-03)。
 */
export const MENU_SURFACE_CLASS = `min-w-32 overflow-hidden animate-in fade-in-0 zoom-in-95 duration-fast ${SURFACE_MENU_CLASS}`

export const MENU_ITEM_CLASS = menuItemVariants()

export const MENU_LABEL_CLASS = menuLabelVariants()

export const MENU_SEPARATOR_CLASS = menuSeparatorVariants()

可访问性与 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。

用法说明

非可视菜单定位/表面工具(.ts),无 demo;被 anchored-menu、filter-chips、toolbar-row 等消费,menu/popover 不直接引用。