Ordo UI
组件Overlays

MenuStyles

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

menu-styles@mox-hub/uiOverlayscanonicalsrc/components/menu-styles.ts

变体轴

inset
truefalse
变体演示menu-styles
demo 待补(demos map 未注册)

Props API

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

源码

packages/ui/src/components/menu-styles.ts
import { cva, type VariantProps } from "class-variance-authority"

/**
 * 菜单配方单一来源(审计 P1-03)。
 *
 * 六个菜单入口(menu / context-menu / menubar / dropdown-menu / navigation-menu /
 * command)以及 Select / Combobox / Autocomplete 的候选项统一消费本文件:
 * - 条目度量:32px 桌面行高,`pointer-coarse` 下 44px 触控目标;
 * - 高亮:Base UI 的 `data-highlighted` 为准,`focus-visible` 兜底非 Base UI 容器;
 * - 图标、inset、destructive、快捷键、分组标签同一套 class。
 *
 * 浮层表面两档的 token 见 theme.css 的 `--surface-*`(P1-02)。
 */

export const SURFACE_MENU_CLASS =
  "rounded-(--surface-menu-radius) border border-(--surface-menu-border) bg-(--surface-menu-bg) text-popover-foreground shadow-xs/5"

export const SURFACE_POPOVER_CLASS =
  "rounded-(--surface-popover-radius) bg-(--surface-popover-bg) text-popover-foreground shadow-(--surface-popover-shadow) ring-1 ring-(--surface-popover-ring)"

const ITEM_INTERACTIVE =
  "cursor-default select-none outline-none transition-[color,background-color] duration-fast ease-standard data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground focus-visible:bg-accent focus-visible:text-accent-foreground"

const ITEM_ICON =
  "pointer-coarse:min-h-11 [&>svg:not([class*='opacity-'])]:opacity-80 [&>svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:-mx-0.5 [&_svg]:shrink-0"

const DESTRUCTIVE =
  "data-[variant=destructive]:text-destructive data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive data-[variant=destructive]:focus-visible:bg-destructive/10 data-[variant=destructive]:focus-visible:text-destructive"

export const menuItemVariants = cva(
  `group/menu-item relative flex min-h-8 w-full items-center gap-2 rounded-sm px-2 py-1 text-sm text-foreground ${ITEM_INTERACTIVE} ${ITEM_ICON} ${DESTRUCTIVE}`,
  {
    variants: {
      inset: {
        true: "ps-8",
        false: "",
      },
    },
    defaultVariants: {
      inset: false,
    },
  }
)

export const menuCheckboxItemVariants = cva(
  `group/menu-item relative grid min-h-8 cursor-default select-none grid-cols-[.75rem_1fr] items-center gap-2 rounded-sm py-1 pe-4 ps-2 text-sm text-foreground outline-none transition-[color,background-color] duration-fast ease-standard data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground focus-visible:bg-accent focus-visible:text-accent-foreground pointer-coarse:min-h-11 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0 ${DESTRUCTIVE}`,
  {
    variants: {
      inset: {
        true: "ps-8",
        false: "",
      },
    },
    defaultVariants: {
      inset: false,
    },
  }
)

export const menuSubTriggerVariants = cva(
  `group/menu-item flex min-h-8 w-full items-center gap-2 rounded-sm px-2 py-1 text-sm text-foreground ${ITEM_INTERACTIVE} data-popup-open:bg-accent data-popup-open:text-accent-foreground ${ITEM_ICON} [&>svg:not(:last-child)]:-mx-0.5`,
  {
    variants: {
      inset: {
        true: "ps-8",
        false: "",
      },
    },
    defaultVariants: {
      inset: false,
    },
  }
)

export const menuLabelVariants = cva(
  "px-2 py-1.5 font-medium text-muted-foreground text-xs",
  {
    variants: {
      inset: {
        true: "ps-9 sm:ps-8",
        false: "",
      },
    },
    defaultVariants: {
      inset: false,
    },
  }
)

export const menuShortcutVariants = cva(
  "ms-auto font-medium font-sans text-muted-foreground text-xs tracking-widest group-data-[highlighted]/menu-item:text-accent-foreground"
)

export const menuSeparatorVariants = cva("mx-2 my-1 h-px bg-border")

export type MenuItemVariantProps = VariantProps<typeof menuItemVariants>

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

用法说明

菜单条目/表面配方单一来源(审计 P1-02/P1-03);menu、context-menu、menubar、dropdown-menu、navigation-menu、command 与 Select/Combobox 共用,不直接对外提供组件 API。