Components/DropdownMenu

DropdownMenu

트리거 버튼에 연결되는 드롭다운 메뉴입니다. Radix UI DropdownMenu 기반.

Installation

bash
npx axis-cli add dropdown-menu

Usage

tsx
import {
  Button,
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuGroup,
  DropdownMenuItem,
  DropdownMenuLabel,
  DropdownMenuSeparator,
  DropdownMenuShortcut,
  DropdownMenuTrigger,
} from '@axis-ds/ui-react'

export function Example() {
  return (
    <DropdownMenu>
      <DropdownMenuTrigger asChild>
        <Button variant="outline">메뉴 열기</Button>
      </DropdownMenuTrigger>
      <DropdownMenuContent className="w-56">
        <DropdownMenuLabel>내 계정</DropdownMenuLabel>
        <DropdownMenuSeparator />
        <DropdownMenuGroup>
          <DropdownMenuItem>
            프로필
            <DropdownMenuShortcut>⇧⌘P</DropdownMenuShortcut>
          </DropdownMenuItem>
          <DropdownMenuItem>
            설정
            <DropdownMenuShortcut>⌘S</DropdownMenuShortcut>
          </DropdownMenuItem>
        </DropdownMenuGroup>
        <DropdownMenuSeparator />
        <DropdownMenuItem>
          로그아웃
          <DropdownMenuShortcut>⇧⌘Q</DropdownMenuShortcut>
        </DropdownMenuItem>
      </DropdownMenuContent>
    </DropdownMenu>
  )
}

Components

DropdownMenu

드롭다운 메뉴 루트 컨테이너

DropdownMenuTrigger

메뉴를 여는 트리거

DropdownMenuContent

메뉴 콘텐츠 영역

DropdownMenuItem

메뉴 아이템

DropdownMenuLabel

메뉴 그룹 레이블

DropdownMenuSeparator

메뉴 아이템 구분선

DropdownMenuGroup

메뉴 아이템 그룹

DropdownMenuShortcut

키보드 단축키 표시

Props

DropdownMenu

open
Type:boolean
Default:-

메뉴 열림 상태 (controlled)

onOpenChange
Type:(open: boolean) => void
Default:-

열림 상태 변경 콜백

modal
Type:boolean
Default:true

모달 모드 여부

DropdownMenuContent

side
Type:"top" | "right" | "bottom" | "left"
Default:"bottom"

메뉴가 나타나는 방향

align
Type:"start" | "center" | "end"
Default:"center"

트리거 대비 정렬

sideOffset
Type:number
Default:0

트리거로부터의 거리 (px)