组件Overlays
MenuStyles
@mox-hub/ui 组件 · Overlays · canonical
menu-styles@mox-hub/uiOverlayscanonicalsrc/components/menu-styles.ts变体轴
insettruefalse
变体演示menu-styles
demo 待补(demos map 未注册)
Props API
未解析到 Props(内部组件或纯静态导出,以源码为准)。
源码
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/translatorprops,其次用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。