组件Navigation
NavigationMenu
@mox-hub/ui 组件 · Navigation · canonical
navigation-menu@mox-hub/uiNavigationcanonicalsrc/components/navigation-menu.tsx变体轴
orientationhorizontalvertical
变体演示navigation-menu
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| className* | string | ((state: NavigationMenuRootState) => string) | — | — |
| children* | ReactNode | — | — |
源码
"use client"
import * as React from "react"
import { NavigationMenu as NavigationMenuPrimitive } from "@base-ui/react/navigation-menu"
import { ChevronDownIcon } from "lucide-react"
import { cn } from "../lib/utils"
import { menuItemVariants } from "./menu-styles"
const navigationMenuTriggerStyle = () =>
"group/trigger inline-flex h-control-md w-max items-center justify-center rounded-md bg-background px-4 py-2 text-sm font-medium transition-[color,background-color] duration-fast hover:bg-muted hover:text-foreground focus:bg-muted focus:text-foreground focus-visible:ring-2 focus-visible:ring-ring/50 focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-popup-open:bg-accent/50 data-popup-open:text-accent-foreground data-popup-open:hover:bg-accent"
function NavigationMenu({
className,
children,
...props
}: NavigationMenuPrimitive.Root.Props) {
return (
<NavigationMenuPrimitive.Root
data-slot="navigation-menu"
className={cn(
"relative flex max-w-max flex-1 items-center justify-center",
className
)}
{...props}
>
{children}
<NavigationMenuViewport />
</NavigationMenuPrimitive.Root>
)
}
function NavigationMenuList({
className,
...props
}: NavigationMenuPrimitive.List.Props) {
return (
<NavigationMenuPrimitive.List
data-slot="navigation-menu-list"
className={cn(
"group flex flex-1 list-none items-center justify-center gap-1",
className
)}
{...props}
/>
)
}
function NavigationMenuItem({
className,
...props
}: NavigationMenuPrimitive.Item.Props) {
return (
<NavigationMenuPrimitive.Item
data-slot="navigation-menu-item"
className={cn("relative", className)}
{...props}
/>
)
}
function NavigationMenuTrigger({
className,
children,
...props
}: NavigationMenuPrimitive.Trigger.Props) {
return (
<NavigationMenuPrimitive.Trigger
data-slot="navigation-menu-trigger"
className={cn(navigationMenuTriggerStyle(), "gap-1", className)}
{...props}
>
{children}
<NavigationMenuPrimitive.Icon
data-slot="navigation-menu-icon"
aria-hidden="true"
className="relative top-px size-3 transition-transform duration-normal ease-standard data-[popup-open]:rotate-180"
>
<ChevronDownIcon className="size-3" />
</NavigationMenuPrimitive.Icon>
</NavigationMenuPrimitive.Trigger>
)
}
function NavigationMenuContent({
className,
...props
}: NavigationMenuPrimitive.Content.Props) {
return (
<NavigationMenuPrimitive.Content
data-slot="navigation-menu-content"
className={cn(
"relative p-2",
"duration-fast data-[open]:animate-in data-[open]:fade-in-0 data-[closed]:animate-out data-[closed]:fade-out-0",
className
)}
{...props}
/>
)
}
function NavigationMenuViewport({
className,
...props
}: NavigationMenuPrimitive.Viewport.Props) {
return (
<NavigationMenuPrimitive.Portal>
<NavigationMenuPrimitive.Positioner
sideOffset={8}
align="start"
className="isolate z-modal"
>
<NavigationMenuPrimitive.Popup className="relative outline-none">
<NavigationMenuPrimitive.Viewport
data-slot="navigation-menu-viewport"
className={cn(
// NavigationMenu 是整宽视口容器:保留 xl 圆角档(审计 P1-02 登记例外),
// 描边/底色/阴影仍走 surface token。
"relative h-[var(--popup-height)] max-h-[85vh] w-[var(--popup-width)] origin-top overflow-y-auto overscroll-contain rounded-(--surface-nav-radius) border border-(--surface-menu-border) bg-(--surface-popover-bg) text-popover-foreground shadow-(--surface-popover-shadow) transition-[width,height] duration-normal ease-standard",
className
)}
{...props}
/>
</NavigationMenuPrimitive.Popup>
</NavigationMenuPrimitive.Positioner>
</NavigationMenuPrimitive.Portal>
)
}
function NavigationMenuLink({
className,
...props
}: NavigationMenuPrimitive.Link.Props) {
return (
<NavigationMenuPrimitive.Link
data-slot="navigation-menu-link"
className={cn(
menuItemVariants(),
"flex-col items-start gap-1 rounded-md p-2 no-underline focus-visible:ring-2 focus-visible:ring-ring/50 data-[active]:bg-accent/50 data-[active]:text-accent-foreground",
className
)}
{...props}
/>
)
}
export {
NavigationMenu,
NavigationMenuContent,
NavigationMenuItem,
NavigationMenuLink,
NavigationMenuList,
NavigationMenuTrigger,
NavigationMenuViewport,
navigationMenuTriggerStyle,
}
可访问性与 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。
用法说明
网站顶部导航菜单,由 NavigationMenu、List、Item、Trigger、Content、Link 组合;桌面 hover/focus 打开,移动端请改用 Sheet。viewport 由组件内置,不需要手动装配。