Playground

Navigation menu

Site navigation with links and menus that open panels of links.

  • 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.

AttributeStylesheet
[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

ClassStylesheet
.navmenunavigation-menu.css
.navmenu-contentnavigation-menu.css
.navmenu-linknavigation-menu.css
.navmenu-listnavigation-menu.css
.navmenu-panelnavigation-menu.css
.navmenu-viewportnavigation-menu.css
.navmenu-viewport-wrapnavigation-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

KeysAction
Arrow keysMove between top-level items
Enter / Space / ArrowDownOpens a panel
EscapeCloses it