Navigation menu
Site navigation with links and menus that open panels of links.
SourceStyles source@monoline/react 0.4.0Markdown for AI toolsstable
- Built on radix-ui/NavigationMenu
- 6 parts, named exports
- A nav landmark with a list of links and menu buttons.
- Arrow keys move between top-level items; Enter/Space/ArrowDown opens a panel; Escape closes it.
- The current page link has aria-current="page".
- Styles in one file:
navigation-menu.css
Import
import '@monoline/css';
import {NavigationMenu} from '@monoline/react';
Not installed yet? Pick a route.
Copies the source and its styles into your project.
npx monoline add navigation-menu
It needs radix-ui; install it if your project does not have it:
npm install radix-ui
Usage
import {NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger} from '@monoline/react';
<div style={{minHeight: '200px'}}>
<NavigationMenu aria-label="Site">
<NavigationMenuList>
<NavigationMenuItem><NavigationMenuLink href="#" active>Home</NavigationMenuLink></NavigationMenuItem>
<NavigationMenuItem>
<NavigationMenuTrigger>Products</NavigationMenuTrigger>
<NavigationMenuContent><div className="navmenu-panel"><NavigationMenuLink href="#">UI kit</NavigationMenuLink><NavigationMenuLink href="#">Icons</NavigationMenuLink><NavigationMenuLink href="#">Templates</NavigationMenuLink></div></NavigationMenuContent>
</NavigationMenuItem>
<NavigationMenuItem><NavigationMenuLink href="#">Docs</NavigationMenuLink></NavigationMenuItem>
</NavigationMenuList>
</NavigationMenu>
</div>
Anatomy
Import the parts you need and nest them like this.
import {NavigationMenu, NavigationMenuList, NavigationMenuItem, NavigationMenuTrigger, NavigationMenuContent, NavigationMenuLink} from '@monoline/react';
<NavigationMenu>
<NavigationMenuList />
<NavigationMenuItem />
<NavigationMenuTrigger />
<NavigationMenuContent />
<NavigationMenuLink />
</NavigationMenu>
Examples
Site navigation
Data Attributes
State is exposed through attributes. Style it with these selectors, not with class toggles.
| Attribute | Stylesheet |
|---|---|
[aria-current="page"] | navigation-menu.css |
[data-active] | navigation-menu.css |
[data-state="closed"] | navigation-menu.css |
[data-state="open"] | navigation-menu.css |
CSS classes
| Class | Stylesheet |
|---|---|
.navmenu | navigation-menu.css |
.navmenu-content | navigation-menu.css |
.navmenu-link | navigation-menu.css |
.navmenu-list | navigation-menu.css |
.navmenu-panel | navigation-menu.css |
.navmenu-viewport | navigation-menu.css |
.navmenu-viewport-wrap | navigation-menu.css |
Customization
Style it with the kit's tokens in your own CSS, loaded after @monoline/css. Prefer the attributes above over extra classes. See Theming for every token.
app.css
.navmenu {
border-color: var(--accent);
}
.navmenu[aria-current="page"] {
background: var(--wash);
}
Accessibility
- A nav landmark with a list of links and menu buttons.
- Arrow keys move between top-level items; Enter/Space/ArrowDown opens a panel; Escape closes it.
- The current page link has aria-current="page".
Keyboard
| Keys | Action |
|---|---|
| Arrow keys | Move between top-level items |
| Enter / Space / ArrowDown | Opens a panel |
| Escape | Closes it |