Get StartedFoundationsComponentsPatternsRulesDevelopAI & ToolsUpdates

Result Section

데이터 로딩 결과나 액션 완료 여부처럼 사용자 행동의 결과를 알려주고 다음 행동을 안내하는 템플릿이에요.

설치

pnpm dlx shadcn@latest add https://rebar.conmarket-landing.workers.dev/r/result-section.json

Anatomy

Result Section은 시각적 이해를 돕는 Asset과 핵심 메시지를 담은 Title을 중심으로, 상세 정보를 위한 Description과 다음 행동을 유도하는 Button을 선택적으로 조합해 구성해요. 모든 구성 요소는 화면에 따라 생략할 수 있어요.

컴포넌트 자체에는 배경색이 없어요.

Properties

Size

Title과 Description은 Large, Medium 두 가지 크기로 제공돼요. 컴포넌트가 놓이는 영역의 크기에 맞춰 선택해요.

Size사용 상황
Large전체 화면을 차지하는 상태를 표현할 때 사용해요.
Medium카드나 섹션 등 페이지의 일부 영역에서 상태를 표현할 때 주로 사용해요.

Buttons

Result Section 영역 안에 버튼을 제공해요. 현재 상태를 해결하거나(재시도) 선택적인 옵션을 제공할 때 적합하고, 버튼을 모두 생략할 수도 있어요. 주요 버튼은 Neutral Weak · Medium, 보조 버튼은 Ghost · Small로 렌더링돼요.

Layout

Result Section은 항상 자신을 감싸는 부모 컨테이너를 기준으로 중앙 정렬돼요. 최상위 레이아웃에 두면 화면 정중앙에, 카드나 섹션 안에 두면 해당 영역 안에서 중앙에 위치해요.

Asset type

자주 쓰는 Asset 타입은 다음과 같아요. asset 슬롯에 원하는 요소를 넣고, 요소 크기에 맞춰 아래 여백(pb-x4 등)을 조절해요.

  • Lottie: 가장 자주 쓰이는 완료(Complete)·실패(Fail) 상태를 애니메이션으로 표현해요. 라이트/다크 모드별 에셋을 따로 준비해요.
  • Icon: 일러스트 대신 아이콘을 쓸 수 있어요. 주로 Empty(데이터 없음) 상태에 사용해요.
  • 2D, 3D Asset: 일반적인 성공·실패가 아닌 서비스 고유의 맥락을 표현할 때 사용해요.
  • Custom: 화면 맥락에 맞는 그래픽을 자유롭게 넣을 수 있어요.

Guidelines

상태별 사용

  • Success / Complete: 사용자의 행동이 성공적으로 완료됐음을 알려줘요. 결과를 명확히 보여주고, 다음 행동이 필요하면 버튼으로 안내해요.
  • Error / Failure: 사용자의 행동이 실패했음을 알려줘요. 사용자가 상황을 이해하고 문제를 해결할 수 있도록 다음에 할 행동을 명확히 안내해요.
  • Empty / First-time use: 화면에 내용이 없음을 알려줘요. 무엇을 해야 할지 알려 주어 행동을 유도하고 이탈을 막아요.

3D Asset 사용

서비스의 맥락과 브랜딩을 강화하기 위해 3D 에셋을 사용할 수 있어요.

Do· 서비스 고유의 경험

특정 서비스에서만 제공하는 경험을 표현할 때 3D 에셋을 사용해요.

Don't· 범용 메시지

"가입 보류" 같은 범용적인 메시지는 3D 에셋으로 표현하지 않아요.

버튼의 위계는 상황에 맞게 조절하기

메시지의 중요도와 사용자가 처한 맥락에 따라 버튼 위계를 정해 다음 행동을 효과적으로 유도해요.

Button 유형설명
Bottom CTA화면 하단 전체를 차지하는 버튼이에요. 시각적 무게감이 가장 크며, 사용자가 가장 먼저 해야 할 핵심 행동을 안내해요.
Contained ButtonResult Section 영역 안에 포함되는 작은 버튼이에요. Bottom CTA보다 중요도가 낮으며, 현재 상태를 해결하거나 보조 정보를 제공해요.

실패 시 화면 맥락에 맞는 액션 제공하기

실패 화면의 이탈 버튼은 현재 화면의 성격(전체 화면 vs 임시 화면)에 따라 구분해서 사용해요.

버튼역할
< (뒤로 가기)입력 오류처럼 수정이 필요할 때 직전 단계로 돌려보내요.
X (닫기)모달이나 팝업 같은 임시 레이어를 닫고 원래 보던 화면으로 돌아가요.
돌아가기되돌아갈 수 없는 상황에서 홈 같은 안전한 목적지로 안내해요.
다시 시도실패한 작업을 바로 다시 실행해요. 위 버튼들과 함께 사용할 수 있어요.

로딩 이후 상태 표현하기

로딩이 끝난 뒤에는 작업 결과에 따라 성공, 실패 등의 Result Section을 이어서 보여주어 명확한 피드백을 제공해요.

Props

Prop

Type

On this page