모달
모달은 대화창의 한 종류로 기본 창에 종속된 요소이다.
사용 지침
확인이 필요한 결정·중요한 폼 입력처럼 컨텍스트를 분리해야 할 때만 신중히 사용하고, 포커스 트랩과 ESC 닫기, 배경 오버레이 클릭 정책을 일관되게 적용합니다.
예제
기본
asChild 트리거
바텀 시트
긴 콘텐츠 초기 본문 포커스
큰 크기
중간 크기
작은 크기
포탈 사용
속성
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
| closeOnEsc | boolean | true | Escape 키로 닫기 (기본값: true). |
| closeOnOverlayClick | boolean | true | 오버레이(딤) 클릭으로 닫기 (기본값: true). |
| defaultOpen | boolean | — | — |
| modal | boolean | — | — |
| onOpenChange | ((open: boolean) => void) | — | — |
| open | boolean | — | — |
| size | enum | md | — |
| variant | enum | default | — |