컴포넌트로 돌아가기
다양한 타입, 선택적 입력 검증, 로딩 상태를 지원하는 확인 모달 컴포넌트입니다.
설치
Import
@hua-labs/ui의 UI 컴포넌트를 @hua-labs/hua에서 통합 제공합니다.
UI 컴포넌트, 모션 훅, i18n을 하나의 패키지로 사용할 수 있습니다.
라이브 데모
타입별 모달
입력 확인 필요
로딩 상태
Props
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
isOpen* | boolean | - | 모달 열림 상태 |
onClose* | () => void | - | 닫기 콜백 |
onConfirm* | () => void | - | 확인 콜백 |
title* | string | - | 모달 제목 |
message* | string | - | 모달 메시지 |
type | "danger" | "warning" | "info" | "success" | "error" | "danger" | 모달 타입 (아이콘 및 버튼 색상에 영향) |
warning | string | - | 추가 경고 메시지 |
confirmText | string | "확인" | 확인 버튼 텍스트 |
cancelText | string | "취소" | 취소 버튼 텍스트 |
loading | boolean | false | 로딩 상태 표시 |
showInput | boolean | false | 확인용 입력 필드 표시 |
size | "sm" | "md" | "lg" | "xl" | "2xl" | "md" | Modal size |
confirmButtonText | string | - | Confirm button text (alias for confirmText) |
disabled | boolean | false | Disable confirm button |
showCancel | boolean | true | Show cancel button |
inputValue | string | - | Input value when showInput is true |
onInputChange | (value: string) => void | - | Input change handler |
inputPlaceholder | string | - | Input placeholder text |
inputLabel | string | - | Input label text |
requiredInputValue | string | - | 확인 버튼 활성화를 위한 필수 입력 값 |
코드 예시
타입별 용도
- •
danger- 삭제, 되돌릴 수 없는 작업 - •
warning- 주의가 필요한 작업 - •
info- 정보 확인, 일반 확인 - •
success- 성공 확인, 완료 확인 - •
error- 에러 확인
접근성
- •포커스 트랩: 모달 내부에 포커스가 유지됩니다
- •ESC 키: ESC 키로 모달 닫기
- •입력 검증: 올바른 입력 전까지 확인 버튼 비활성화