Ordo UI
组件Navigation

NavigationMenu

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

navigation-menu@mox-hub/uiNavigationcanonicalsrc/components/navigation-menu.tsx

变体轴

orientation
horizontalvertical
变体演示navigation-menu

Props API

Prop类型默认值说明
className*string | ((state: NavigationMenuRootState) => string)——
children*ReactNode——

源码

packages/ui/src/components/navigation-menu.tsx
"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 /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

网站顶部导航菜单,由 NavigationMenu、List、Item、Trigger、Content、Link 组合;桌面 hover/focus 打开,移动端请改用 Sheet。viewport 由组件内置,不需要手动装配。