A site's top navigation as a strip of index dividers: pencil-sketched tabs standing on a pencil line, the open one lifted and washed with highlighter, the current page filled. Its panel drops from under the strip as a slip of paper that follows the size of what is inside, and a felt-tip underline slides along to the open tab. Hover intent, arrow keys and the motion between panels are Radix's.
The shadcn demo on an index strip: a featured card with the mascot beside three rows, a two-column panel of components, and a plain tab. Move from Getting started to Components: the slip resizes, the panels slide inside it and the felt-tip underline glides along.
Links only
No panels: a strip of links. In the strip a link is a tab like the triggers, and the current page (active) is filled with highlighter with aria-current. Arrow keys walk the tabs; asChild puts the tab on your router's link.
A slip under each tab
viewport={false}: there is no shared slip, so each panel is a slip of its own set down under its tab, at the size of its contents. Good for short menus of a few links.
Site header (composed)
A real use: the logo, the strip and the account buttons in one header on a sheet of paper. The panels open over the page below; the sign-in button is a normal Button.
Six items (as written)
shadcn's `navigation-menu-demo` line for line: `viewport={isMobile}` from `useIsMobile()`, `navigationMenuTriggerStyle()` on a plain link, `flex-wrap` on the list, the last three panels hidden below `md`, and a ListItem helper. Link is an `<a>` here (shadcn's uses next/link).
API 参考
NavigationMenu
The Radix root (`nav`). Renders the shared viewport slip after its children unless told not to. The panel is not portalled: it hangs from the strip, so its `z-index` counts inside the nearest stacking context. Inside a Paper, a card or any other isolated header, give that element a z-index (`z-(--ll-z-raised)`) so the panel drops over the content that follows it.
属性
类型
默认值
说明
viewport
boolean
true
One slip shared by every panel, resized to the open one (and the panels slide inside it). `false`: each panel is a slip of its own set down under its tab.
value / defaultValue / onValueChange
string / string / (value: string) => void
-
Which item is open.
delayDuration / skipDelayDuration
number
200 / 300
Hover intent, in ms.
dir / orientation
-
Radix's. The tabs, arrows and drawings follow the reading direction.
NavigationMenuTrigger
A tab that opens a panel (a button, `aria-expanded`). Its drawing: a faint pencil sketch at rest, highlighter and felt under the pointer, lifted with a wash while open. The chevron turns over when it opens.
属性
类型
默认值
说明
seed
string | number
-
Pins the hand: the same seed always draws the same tab. Default: from useId().
disabled
boolean
false
A dashed pencil tab that does not open.
NavigationMenuLink
A link. Inside a panel it is a row that wears the highlighter (the current one stays on it). In the strip itself it is a tab, like the triggers, and the current page (`active`) is filled with highlighter: pass `asChild` to use your router's link. Inside a panel every svg without a `size-*` class is drawn 16 px (the icon rule), so give art such as a Mascot an explicit size.
属性
类型
默认值
说明
active
boolean
false
The current page: `aria-current="page"`, `data-active`, and the filled tab.
asChild
boolean
false
Render your link; the tab's drawing lands inside it.
seed
string | number
-
Pins the hand of a tab link.
无障碍
Radix NavigationMenu: a `nav` landmark (give it `aria-label`), a list of items, triggers with `aria-expanded` and `aria-controls`. It is a disclosure pattern, not `role=menu`: panels hold ordinary links.
Hover (with intent delay), click and Enter or Space open a panel; Escape closes it and returns focus to its trigger. Left and Right (mirrored in RTL) move between triggers and links, ArrowDown from an open trigger steps into the panel, and Tab moves through the panel's links and on. Focus leaving the menu closes it.
The current page is `aria-current="page"` and a filled tab, so it does not depend on color. The sketches, the pencil line, the underline and the highlighter are aria-hidden decoration with no pointer events. Tabs are 36 px high (32 compact, 28 calm).
Touch: a tap opens a panel (hover is not needed). Reduced motion removes the drop, the slide between panels and the underline's glide. In forced-colors mode the drawings give way to real outlines.