Navigation Menu
A simplified wrapper for Shadcn Navigation Menu with flexible option handling and automatic type conversion
Installation
npx shadcn@latest add @glrk-ui/navigation-menuIf you haven't set up the prerequisites yet, check out Prerequest section.
Copy and paste the following code into your project.
import { NavigationMenu as NavigationMenuPrimitive } from "@base-ui/react/navigation-menu"
import { ChevronDownIcon } from "lucide-react"
import { cva } from "class-variance-authority"
import { cn } from "@/lib/utils"
function NavigationMenu({
align = "start",
className,
children,
...props
}: NavigationMenuPrimitive.Root.Props &
Pick<NavigationMenuPrimitive.Positioner.Props, "align">) {
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} />
</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-0",
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 h-9 w-max items-center justify-center rounded-lg bg-background px-2.5 py-1.5 text-sm font-medium transition-all outline-none hover:bg-muted focus:bg-muted focus-visible:ring-3 focus-visible:ring-ring/50 focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-popup-open:bg-muted/50 data-popup-open:hover:bg-muted data-open:bg-muted/50 data-open:hover:bg-muted data-open:focus:bg-muted"
)
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(
"data-ending-style:data-activation-direction=left:translate-x-[50%] data-ending-style:data-activation-direction=right:translate-x-[-50%] data-starting-style:data-activation-direction=left:translate-x-[-50%] data-starting-style:data-activation-direction=right:translate-x-[50%] h-full w-auto p-1 transition-[opacity,transform,translate] duration-[0.35s] ease-[cubic-bezier(0.22,1,0.36,1)] group-data-[viewport=false]/navigation-menu:rounded-lg group-data-[viewport=false]/navigation-menu:bg-popover group-data-[viewport=false]/navigation-menu:text-popover-foreground group-data-[viewport=false]/navigation-menu:shadow group-data-[viewport=false]/navigation-menu:ring-1 group-data-[viewport=false]/navigation-menu:ring-foreground/10 group-data-[viewport=false]/navigation-menu:duration-300 data-ending-style:opacity-0 data-starting-style:opacity-0 data-[motion=from-end]:slide-in-from-right-52 data-[motion=from-start]:slide-in-from-left-52 data-[motion=to-end]:slide-out-to-right-52 data-[motion=to-start]:slide-out-to-left-52 data-[motion^=from-]:animate-in data-[motion^=from-]:fade-in data-[motion^=to-]:animate-out data-[motion^=to-]:fade-out **:data-[slot=navigation-menu-link]:focus:ring-0 **:data-[slot=navigation-menu-link]:focus:outline-none group-data-[viewport=false]/navigation-menu:data-open:animate-in group-data-[viewport=false]/navigation-menu:data-open:fade-in-0 group-data-[viewport=false]/navigation-menu:data-open:zoom-in-95 group-data-[viewport=false]/navigation-menu:data-closed:animate-out group-data-[viewport=false]/navigation-menu:data-closed:fade-out-0 group-data-[viewport=false]/navigation-menu:data-closed:zoom-out-95",
className
)}
{...props}
/>
)
}
function NavigationMenuPositioner({
className,
side = "bottom",
sideOffset = 8,
align = "start",
alignOffset = 0,
...props
}: NavigationMenuPrimitive.Positioner.Props) {
return (
<NavigationMenuPrimitive.Portal>
<NavigationMenuPrimitive.Positioner
side={side}
sideOffset={sideOffset}
align={align}
alignOffset={alignOffset}
className={cn(
"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) origin-(--transform-origin) rounded-lg bg-popover text-popover-foreground shadow 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({ className, ...props }: NavigationMenuPrimitive.Link.Props) {
return (
<NavigationMenuPrimitive.Link
data-slot="navigation-menu-link"
className={cn(
"flex items-center gap-2 rounded-lg p-2 text-sm transition-all outline-none hover:bg-muted focus:bg-muted focus-visible:ring-3 focus-visible:ring-ring/50 focus-visible:outline-1 in-data-[slot=navigation-menu-content]:rounded-md data-active:bg-muted/50 data-active:hover:bg-muted data-active:focus:bg-muted [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
/>
)
}
function NavigationMenuIndicator({ className, ...props }: React.ComponentPropsWithRef<typeof NavigationMenuPrimitive.Icon>) {
return (
<NavigationMenuPrimitive.Icon
data-slot="navigation-menu-indicator"
className={cn(
"top-full flex h-1.5 items-end justify-center overflow-hidden data-[state=hidden]:animate-out data-[state=hidden]:fade-out data-[state=visible]:animate-in data-[state=visible]:fade-in",
className
)}
{...props}
>
<div className="relative top-[60%] h-2 w-2 rotate-45 rounded-tl-sm bg-border shadow-md" />
</NavigationMenuPrimitive.Icon>
)
}
export {
NavigationMenu,
NavigationMenuContent,
NavigationMenuIndicator,
NavigationMenuItem,
NavigationMenuLink,
NavigationMenuList,
NavigationMenuTrigger,
navigationMenuTriggerStyle,
NavigationMenuPositioner,
}"use client"
import Link, { type LinkProps } from "next/link"
import { cn } from "@/lib/utils"
import {
NavigationMenu,
NavigationMenuList,
NavigationMenuItem,
NavigationMenuTrigger,
NavigationMenuContent,
NavigationMenuLink,
navigationMenuTriggerStyle,
} from "@/components/ui/navigation-menu"
type navLinkItemT = LinkProps & {
children: React.ReactNode
className?: string
}
type navLinkItemsT = navLinkItemT[]
type navMenuItemT = {
key: string
itemProps?: React.ComponentProps<typeof NavigationMenuItem>
} & (
| {
trigger: React.ReactNode
content: React.ReactNode
triggerCls?: string
contentCls?: string
contentProps?: React.ComponentProps<typeof NavigationMenuContent>
}
| navLinkItemT
)
type navMenuItemsT = navMenuItemT[]
function NavLinkItem({ children, className, ...props }: navLinkItemT) {
return (
<NavigationMenuLink
render={
<Link {...props} className={cn("flex flex-row items-center gap-2", className)}>
{children}
</Link>
}
/>
)
}
type listWrapperProps = {
items: navLinkItemsT
wrapperCls?: string
}
function NavList({ items, wrapperCls }: listWrapperProps) {
return (
<ul className={cn(wrapperCls)}>
{items.map((item, i) => (
<li key={i}>
<NavLinkItem
{...item}
className={cn(item.className)}
/>
</li>
))}
</ul>
)
}
type wrapperProps = React.ComponentProps<typeof NavigationMenu> & {
items: navMenuItemsT
triggerCls?: string
contentCls?: string
}
function NavigationMenuWrapper({
items,
className,
triggerCls,
contentCls,
...props
}: wrapperProps) {
return (
<NavigationMenu className={className} {...props}>
<NavigationMenuList>
{items.map(itemWrap => {
const { key, ...item } = itemWrap
if ("trigger" in item) {
return (
<NavigationMenuItem key={key} {...item.itemProps}>
<NavigationMenuTrigger className={cn(triggerCls, item.triggerCls)}>
{item.trigger}
</NavigationMenuTrigger>
<NavigationMenuContent
{...item.contentProps}
className={cn(contentCls, item.contentCls)}
>
{item.content}
</NavigationMenuContent>
</NavigationMenuItem>
)
}
return (
<NavigationMenuItem key={key} {...item.itemProps}>
<NavLinkItem
{...item}
className={cn(navigationMenuTriggerStyle(), item?.className)}
/>
</NavigationMenuItem>
)
})}
</NavigationMenuList>
</NavigationMenu>
)
}
export {
NavList,
NavLinkItem,
NavigationMenuWrapper,
type navMenuItemT,
type navMenuItemsT,
type navLinkItemT,
type navLinkItemsT,
}Usage
Complex
import { CircleHelpIcon } from "lucide-react"
import { NavigationMenuWrapper, NavLinkItem, NavList } from "@/components/ui/navigation-menu-wrapper"
export function Complex() {
const dropdownOptions = ["Option 1", "Option 2", "Option 3"]
return (
<NavigationMenuWrapper
items={[
{
key: "home",
trigger: "Home",
content: (
<div className="p-2 w-[250px]">
<NavList
items={[
{ href: "/", children: "Dashboard" },
{ href: "/about", children: "About Us" },
]}
/>
</div>
),
}, {
key: "pricing",
href: "/pricing",
children: "Pricing",
},
{
key: "features",
trigger: "Features",
content: (
<div className="p-2 w-[300px]">
<div className="text-lg font-semibold">Product Features</div>
<NavList
items={[
{ href: "/fast", children: "Fast Performance" },
{ href: "/secure", children: "Secure Infrastructure" },
{
href: "/todo",
children: <><CircleHelpIcon className="size-4" /> Backlog</>,
},
]}
/>
<NavLinkItem href="/dashbard" >
Dashboard
</NavLinkItem>
</div>
),
}
]}
/>
)
}Reference
Component Hierarchy
NavigationMenuWrapper (Main component)
└─ NavigationMenuList
└─ NavigationMenuItem (repeated for each item)
├─ NavLinkItem (for type="link")
│ └─ Next.js Link
│
└─ NavigationMenuTrigger + Content (for type="trigger")
├─ Trigger element
└─ NavigationMenuContent
└─ Custom content (can include NavList)
NavList (Standalone component)
└─ <ul>
└─ <li> (repeated for each item)
└─ NavLinkItem
└─ Next.js Link