컴포넌트 · 피드백

Skeleton · EmptyState

데이터를 불러오는 동안에는 실제 레이아웃과 같은 모양의 Skeleton을, 데이터가 없을 때는 이유와 다음 행동을 알려주는 EmptyState를 보여줍니다.

Skeleton

대기 시간표시
0 – 300ms아무것도 표시하지 않음 (깜빡임 방지)
300ms – 5초Skeleton
5초 이상Skeleton + 안내 문구 (예: 카드사 응답을 기다리고 있어요)

EmptyState

아직 거래가 없어요

첫 결제가 들어오면 여기에 표시돼요

검색 결과가 없어요

기간이나 필터를 바꿔 보세요

불러오지 못했어요

인터넷 연결을 확인해 주세요

사용 규칙

이렇게 하세요

  • Skeleton 모양은 실제 콘텐츠와 동일하게
  • 빈 상태는 원인별로 다르게 (없음 · 검색 결과 없음 · 오류)
  • 다음 행동 버튼 제공

이렇게 하지 마세요

  • 화면 전체를 스피너로 가리기
  • 빈 상태에 장식 일러스트만 크게
  • 오류와 ‘데이터 없음’을 같은 문구로

Props

PropTypeDefault설명
Skeleton.classNamestring—크기 지정 (h-*, w-*)
Skeleton.circleboolean—원형
EmptyState.icon · title · description · actionReactNode—구성 요소
EmptyState.size"sm" | "md" | "lg""md"세로 여백