Components
Navigation Menu
A collection of links for navigating websites.
Loading...
Installation
CLI
npx shadcn@latest add https://exawizards.com/exabase/design/registry/navigation-menu.jsonManual
Copy and paste the following code into your project.
import { NavigationMenu as NavigationMenuPrimitive } from "@base-ui/react/navigation-menu"
import { cva } from "class-variance-authority"
import { ChevronDownIcon } from "@exawizards/exabase-design-system-icons-react"
import { cn } from "@/lib/utils"
function NavigationMenu({
align = "start",
collisionPadding = 4,
className,
children,
...props
}: NavigationMenuPrimitive.Root.Props &
Pick<
NavigationMenuPrimitive.Positioner.Props,
"align" | "collisionPadding"
>) {
return (
<NavigationMenuPrimitive.Root
data-slot="navigation-menu"
className={cn(
"group/navigation-menu relative flex max-w-max flex-1 items-center justify-center",
className
)}
{...props}
>
{children}
<NavigationMenuPositioner
align={align}
collisionPadding={collisionPadding}
/>
</NavigationMenuPrimitive.Root>
)
}
function NavigationMenuList({
className,
...props
}: React.ComponentPropsWithRef<typeof NavigationMenuPrimitive.List>) {
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
}: React.ComponentPropsWithRef<typeof NavigationMenuPrimitive.Item>) {
return (
<NavigationMenuPrimitive.Item
data-slot="navigation-menu-item"
className={cn("relative", className)}
{...props}
/>
)
}
const navigationMenuTriggerStyle = cva(
"group/navigation-menu-trigger inline-flex w-max items-center justify-center rounded-lg px-2.5 py-1.5 text-sm font-medium whitespace-nowrap text-foreground transition-all outline-none hover:bg-accent focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50"
)
function NavigationMenuTrigger({
className,
children,
...props
}: NavigationMenuPrimitive.Trigger.Props) {
return (
<NavigationMenuPrimitive.Trigger
data-slot="navigation-menu-trigger"
className={cn(navigationMenuTriggerStyle(), "group", className)}
{...props}
>
{children}
<ChevronDownIcon
className="relative top-px ml-1 size-3 transition duration-300 group-data-popup-open/navigation-menu-trigger:rotate-180 group-data-open/navigation-menu-trigger:rotate-180"
aria-hidden="true"
/>
</NavigationMenuPrimitive.Trigger>
)
}
function NavigationMenuContent({
className,
...props
}: NavigationMenuPrimitive.Content.Props) {
return (
<NavigationMenuPrimitive.Content
data-slot="navigation-menu-content"
className={cn(
"h-full w-auto p-2 pr-2.5 transition-[opacity] duration-[0.35s] ease-[cubic-bezier(0.22,1,0.36,1)] data-ending-style:opacity-0 data-starting-style:opacity-0",
className
)}
{...props}
/>
)
}
function NavigationMenuPositioner({
className,
side = "bottom",
sideOffset = 4,
align = "start",
alignOffset = 0,
...props
}: NavigationMenuPrimitive.Positioner.Props) {
return (
<NavigationMenuPrimitive.Portal data-slot="navigation-menu-portal">
<NavigationMenuPrimitive.Positioner
data-slot="navigation-menu-positioner"
side={side}
sideOffset={sideOffset}
align={align}
alignOffset={alignOffset}
className={cn(
"isolate z-50 h-(--positioner-height) w-(--positioner-width) max-w-(--available-width) transition-[top,left,right,bottom] duration-[0.35s] ease-[cubic-bezier(0.22,1,0.36,1)] data-instant:transition-none data-[side=bottom]:before:top-[-10px] data-[side=bottom]:before:right-0 data-[side=bottom]:before:left-0",
className
)}
{...props}
>
<NavigationMenuPrimitive.Popup className="data-[ending-style]:easing-[ease] xs:w-(--popup-width) relative h-(--popup-height) w-(--popup-width) max-w-(--available-width) origin-(--transform-origin) rounded-lg bg-popover text-popover-foreground shadow-sm ring-1 ring-foreground/10 transition-[opacity,transform,width,height,scale,translate] duration-[0.35s] ease-[cubic-bezier(0.22,1,0.36,1)] outline-none data-ending-style:scale-90 data-ending-style:opacity-0 data-ending-style:duration-150 data-starting-style:scale-90 data-starting-style:opacity-0">
<NavigationMenuPrimitive.Viewport className="relative size-full overflow-hidden" />
</NavigationMenuPrimitive.Popup>
</NavigationMenuPrimitive.Positioner>
</NavigationMenuPrimitive.Portal>
)
}
function NavigationMenuLink({ ...props }: NavigationMenuPrimitive.Link.Props) {
return (
<NavigationMenuPrimitive.Link data-slot="navigation-menu-link" {...props} />
)
}
export {
NavigationMenu,
NavigationMenuContent,
NavigationMenuItem,
NavigationMenuLink,
NavigationMenuList,
NavigationMenuTrigger,
navigationMenuTriggerStyle,
NavigationMenuPositioner,
}
Anatomy
NavigationMenu
NavigationMenuList
NavigationMenuItem
NavigationMenuTrigger
NavigationMenuContent
NavigationMenuLink
NavigationMenuLink
NavigationMenuItem
NavigationMenuLink
- NavigationMenu: Groups all parts of the navigation menu. Renders a
<nav>element at the root, or<div>element when nested.- NavigationMenuList: Contains a list of navigation menu items. Renders a
<ul>element.- NavigationMenuItem: An individual navigation menu item. Renders a
<li>element.- NavigationMenuTrigger: Opens the navigation menu popup when hovered or clicked, revealing the associated content. Renders a
<button>element. - NavigationMenuContent: The dropdown panel displayed when the trigger is activated.
- NavigationMenuLink: A link in the navigation menu that can be used to navigate to a different page or section. Renders an
<a>element.
- NavigationMenuTrigger: Opens the navigation menu popup when hovered or clicked, revealing the associated content. Renders a
- NavigationMenuItem: An individual navigation menu item. Renders a
- NavigationMenuList: Contains a list of navigation menu items. Renders a
Usage
import {
NavigationMenu,
NavigationMenuContent,
NavigationMenuItem,
NavigationMenuLink,
NavigationMenuList,
NavigationMenuTrigger,
} from "@/components/ui/navigation-menu"<NavigationMenu>
<NavigationMenuList>
{/* As dropdown menu */}
<NavigationMenuItem>
<NavigationMenuTrigger>Menu</NavigationMenuTrigger>
<NavigationMenuContent>
<NavigationMenuLink>Link</NavigationMenuLink>
</NavigationMenuContent>
</NavigationMenuItem>
{/* As simple link */}
<NavigationMenuItem>
<NavigationMenuLink
render={<Link href="#" />}
className={navigationMenuTriggerStyle()}
>
Link
</NavigationMenuLink>
</NavigationMenuItem>
</NavigationMenuList>
</NavigationMenu>Examples
Link
Use the render prop to compose a custom link component such as Next.js Link.
import Link from "next/link"
import {
NavigationMenuItem,
NavigationMenuLink,
navigationMenuTriggerStyle,
} from "@/components/ui/navigation-menu"
export function NavigationMenuDemo() {
return (
<NavigationMenuItem>
<NavigationMenuLink
render={<Link href="/docs" />}
className={navigationMenuTriggerStyle()}
>
Documentation
</NavigationMenuLink>
</NavigationMenuItem>
)
}Align Center
Loading...
Mega Menu
Loading...
API
See the Base UI documentation for more information.