03 · Components · 피드백
토스트Toast
화면 구석에 짧게 나타났다 사라지는 알림. 저장·삭제 같은 비파괴적 결과 피드백에 적합합니다. 사용자의 흐름을 방해하지 않습니다.
StableWCAG AA
기본
사용 가이드
- 3-5초 내에 사라지게 하세요. 오류 메시지는 닫기 버튼을 제공합니다.
- 한 번에 3개 이하로 제한합니다. 그 이상이면 가장 오래된 것부터 제거.
- 중요한 파괴적 동작의 결과는 Modal 확인이 더 안전합니다.
Toast 영역은 role="region" aria-label="알림"으로 감싸며 각 토스트는 role="status"를 가져 스크린리더가 흐름을 방해하지 않고 낭독합니다. 중요한 오류는 role="alert"로 바꿔 즉시 낭독되게 할 수 있습니다.
useToast API
| Prop | Type | Default | Description |
|---|---|---|---|
message | string | 본문 메시지 (필수). | |
title | string | 굵은 제목. | |
variant | "info" | "success" | "warning" | "danger" | "info" | 의미 색상. |
duration | number (ms) | 4000 | 자동 닫힘 시간. 0이면 자동 닫지 않음. |