Navigation Menu
버튼을 열어 관련 링크 묶음을 보여 주는 사이트 상단 탐색에 사용합니다.
미리보기
제품 탐색 메뉴
제품 메뉴에서 컴포넌트·테마 링크를 열거나 안내 링크로 해당 영역에 바로 이동합니다.
미리보기를 불러오는 중입니다.
설치
Registry를 처음 사용한다면 기본 설정과 공통 스타일 설치 을 먼저 완료하세요.
npx shadcn@latest add @neumorphism-ui/navigation-menu공통 base를 한 번 설치한 뒤 CLI로 필요한 컴포넌트와 의존성을 추가합니다.
사용법
목록과 항목을 구성하고 각 트리거에 콘텐츠를 연결한 뒤 NavigationMenuViewport를 배치하세요. 펼친 영역의 NavigationMenuLink에는 실제 이동 대상을 제공합니다.
"use client";
import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport } from "@/components/ui/navigation-menu";
export default function Example() {
return (
<NavigationMenu aria-label="Main navigation">
<NavigationMenuList>
<NavigationMenuItem>
<NavigationMenuTrigger>Resources</NavigationMenuTrigger>
<NavigationMenuContent><NavigationMenuLink href="/guides">Guides</NavigationMenuLink></NavigationMenuContent>
</NavigationMenuItem>
</NavigationMenuList>
<NavigationMenuViewport />
</NavigationMenu>
);
}API 레퍼런스
Base UI의 탐색 상태를 유지하고 열린 메뉴를 inset 표면으로 표현합니다. NavigationMenuViewport를 루트 안에 한 번 배치합니다.
| 컴포넌트 | 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
NavigationMenu | value / onValueChange | NavigationMenu.Root.Props | — | 현재 열린 항목과 변경 콜백입니다. |
NavigationMenuLink | render | ReactElement | — | 프레임워크 링크를 render로 연결합니다. |
NavigationMenuViewport | side / align / sideOffset | NavigationMenuViewportProps | — | 팝업의 위치와 여백을 지정합니다. |
접근성
- 01
사이트 이동에는 실제 href 링크를 사용하고 nav에 이름을 부여하세요.
- 02
Tab·방향키·Escape로 조작하고, 포커스 표시를 제거하지 마세요.