컴포넌트 · 피드백

Toast · Alert

Toast는 방금 한 행동의 결과를 잠깐 알리고 사라집니다. Alert는 화면에 머물면서 사용자가 알아야 할 상태나 주의 사항을 전달합니다.

무엇을 쓸까

컴포넌트지속용도예시
Toast3.2초 후 자동 닫힘행동의 결과 피드백저장되었어요 · 복사됨
Toast + 액션3.2초되돌릴 수 있는 행동메뉴를 숨겼어요 [실행 취소]
Alert사용자가 닫을 때까지화면 맥락의 상태 · 주의정산 계좌 인증이 필요해요
ConfirmDialog응답할 때까지중요한 결정결제를 취소할까요?

Toast

버튼을 눌러 실제 토스트를 띄워 보세요. 최대 3개까지 쌓이고 오래된 것부터 사라집니다.

정산 계좌가 변경되었어요
네트워크 연결이 불안정해요
메뉴 ‘아메리카노’를 숨겼어요

Alert

10월 1일 정산은 공휴일로 10월 2일에 지급돼요

정산 계좌 인증이 필요해요

인증을 완료하지 않으면 다음 정산이 보류됩니다.

사업자 인증이 완료되었어요

이 가맹점은 테스트 모드로 운영 중입니다.

사용 규칙

이렇게 하세요

  • 토스트 문구는 한 줄, 결과를 과거형으로 (저장되었어요)
  • 오류는 원인 + 해결 방법 (Alert · 필드 메시지)
  • 모바일 토스트는 하단 CTA 위에

이렇게 하지 마세요

  • 결제 실패처럼 중요한 오류를 토스트로만 알림
  • 토스트에 버튼 2개 이상
  • 성공할 때마다 모달 띄우기

Props

PropTypeDefault설명
useToast().show(message, { tone?, action? }) => void—ToastProvider 내부에서 호출
Toast.tone"default" | "positive" | "negative""default"아이콘
Alert.tone"info" | "positive" | "warning" | "negative" | "neutral""info"색 · 아이콘 · role
Alert.action · onCloseReactNode · () => void—액션 버튼 · 닫기