Toast

사용자의 행동에 대한 간단한 피드백을 제공하는 알림 창입니다. 화면 하단에 나타나 사용자의 현재 작업을 방해하지 않으며, 일정 시간이 지나면 자동으로 사라집니다.

Anatomy

  1. 1Container
  2. 2Leading icon
  3. 3Message

Variants

Message

Variants
Leading icon

Size

기본 높이는 54px로, 텍스트는 최대 2줄까지 표시됩니다. 최대 너비는 420px로 제한합니다.

Status

메시지의 성격에 따라 아이콘과 색상을 구분하여, 사용자가 상황을 즉시 인지할 수 있도록 돕습니다.

  • Normal: 단순 정보 전달이나 상태 변경을 알리는 등 중립적인 피드백에 사용합니다.
  • Positive: 사용자가 요청한 작업이 성공적으로 완료되었음을 알리는 긍정적인 피드백에 사용합니다.
  • Cautionary: 치명적인 오류는 아니지만, 사용자에게 주의가 필요한 상황을 알리기 위해 사용합니다.
  • Negative: 작업이 실패했거나 오류가 발생했음을 알리는 부정적인 피드백입니다.

Usage

Position - iOS

화면 좌우에 20px의 여백을 두는 것을 기본으로 합니다. 화면 너비가 넓어질 경우, Toast는 최대 너비(420px)를 유지하며

화면 중앙에 위치합니다. 화면 하단 UI 요소와의 상호작용을 방해하지 않도록 다음과 같이 사용하는 것을 권장합니다.

  • Default: Safe area 영역을 제외하고 20pt 위에서 노출합니다.
  • Bottom navigation이 있는 경우: Bottom navigation으로부터 20pt 위에 노출합니다.
  • Action area가 있는 경우: Extra 영역을 제외한 Action area 영역 바로 위에 붙어서 노출합니다.

Position - Android

화면 좌우에 20dp의 여백을 두는 것을 기본으로 합니다. 화면 너비가 넓어질 겨우, Toast는 최대 너비(420px)를 유지하며

화면 중앙에 위치합니다. Android OS 가이드라인에 따라 다음 기준에 맞춰 사용하는 것을 권장합니다.

  • Default: Safe area 영역을 제외하고 16dp 위에서 노출합니다.
  • Bottom navigation이 있는 경우: Bottom navigation으로부터 16dp 위에서 노출합니다.
  • Action area가 있는 경우: Safe area 영역을 제외하고 16dp 위에서 노출합니다.

Position - Web Mobile

화면 좌우에 20px의 여백을 두는 것을 기본으로 합니다. 화면 너비가 넓어질 경우, Toast는 최대 너비(420px)를 유지하며

화면 중앙에 위치합니다. 모바일 웹에서 화면 하단 UI 요소와의 상호작용을 방해하지 않도록 다음과 같이 사용하는 것을 권장합니다.

  • Default: Safe area 영역을 제외하고 20px 위에서 노출합니다.
  • Bottom navigation이 있는 경우: Bottom navigation으로부터 20px 위에 노출합니다.
  • Action area가 있는 경우: Extra 영역을 제외한 Action area 영역 바로 위에 붙어서 노출합니다.

Position - Web desktop

데스크톱 웹에서는 화면 하단으로부터 40px 위에 위치가 고정되며, 임의로 변경할 수 없습니다. 화면이 768px 이상일 때 Toast의 최소 너비는 356px로 제한합니다.

How to use

Do

간결하고 명확한 메시지를 즉각적으로 제공합니다.

Don’t

사용자의 상호작용을 유도하는 액션을 제공하지 않습니다.

Customize

List cell
icon

© 2026 Wanted Lab, Inc.