Empty State

표시할 내용이 없을 때 이유와 다음 행동을 안내합니다.

실제 미리보기

사용할 때

사용 기준

검색 결과, 문서, 목록이 비어 있는 실제 상태에 씁니다.

사용하지 않을 때

예시 데이터를 꾸며 빈 공간을 채우거나 일반 홍보 영역으로 쓰지 않습니다.

변형과 상태

  • default고정 예시

    제목과 설명이 원인을 구체적으로 말하는지 확인합니다.

  • action고정 예시

    가능한 다음 행동이 하나의 명확한 버튼으로 제공되는지 확인합니다.

접근성

제목과 설명만으로 상태를 이해할 수 있고 가능할 때 복구 동작을 제공합니다.

API

속성타입필수설명
titleReactNode예빈 상태를 요약하는 제목입니다.
descriptionReactNode예이유나 다음 단계를 설명합니다.
actionReactNode아니요복구나 생성으로 이어지는 동작입니다.

사용 예시

지원 importimport { EmptyState } from "@/components/ui/empty-state"

TSX
<EmptyState
  title="No documents"
  description="Create the first document."
  action={<Button>Create</Button>}
/>
모든 컴포넌트 보기