Alert · Overview

스토리북 개발자들을 위한 내부 문서

Components

Alert

Overview

사용자에게 정보, 경고, 오류, 성공 상태를 전달하는 피드백 컴포넌트입니다. 컨텍스트와 긴급도에 따라 적절한 변형·위치·레이아웃을 선택합니다.

State

알럿의 의미와 긴급도를 나타냅니다. 상황에 맞는 상태를 선택해 사용자가 메시지의 중요도를 빠르게 파악할 수 있도록 합니다.

  • Fail해결하지 않으면 진행 불가. 즉각 조치 필요한 상황에 사용합니다.
  • Warning진행은 가능하지만 확인 후 넘어가야 하는 상황에 사용합니다.
  • Success작업 완료. 사용자가 결과를 인지해야 하는 상황에 사용합니다.
  • Info선택적 정보. 진행, 액션에 지장 없는 상황에 사용합니다.

Fail

Warning

주의

확인이 필요한 항목이 있습니다.

Success

성공

요청이 성공적으로 처리되었습니다.

Info

안내

참고할 안내 사항이 있습니다.
Position

뷰포트 기준 고정 위치(top / center / bottom)입니다. 도식으로 배치를 확인하고, 미리보기로 실제 Alert를 띄울 수 있습니다.

  • Top페이지 또는 섹션 상단에 표시됩니다. 진입 시 즉시 확인이 필요한 공지나 오류에 사용합니다.
  • Center페이지 또는 섹션 중앙에 표시됩니다. 폼 오류, 섹션별 안내처럼 특정 영역과 연결된 메시지에 사용합니다.
  • Bottom페이지 또는 섹션 하단에 표시됩니다. 흐름을 방해하지 않으면서 보조적인 안내를 전달할 때 사용합니다.

Top

Center

Bottom

Variants

알럿의 레이아웃 구조를 결정합니다. 전달할 정보의 양과 위계에 따라 선택합니다.

  • Block제목과 설명이 함께 표시되는 구조. 설명은 최대 2줄 이내로 작성합니다.
  • Inline메시지 한 줄만 표시되는 구조. 간단한 상태 전달에 사용합니다. 메세지는 최대 1줄 이내로 작성합니다.

Block

Inline