Fallback view

화면에 표시할 데이터가 없을 때 사용자에게 현재 상황을 알려주는 요소입니다. 단순히 비어있음을 알리는 것을 넘어, 다음에 무엇을 해야 할지 안내하는 메시지와 액션 버튼을 함께 제공하여 사용 흐름이 끊기지 않도록 돕습니다.

@MainActor struct FallbackView

Overview

데이터 없음, 검색 결과 없음(Empty) 뿐 아니라 404/네트워크 오류 등의 상태를 시각적으로 표현하고 사용자에게 적절한 안내/복구 액션을 제공합니다. 이미지, 제목, 설명, 버튼 요소를 조합하여 다양한 상황에 맞는 대체(Fallback) 화면을 구성할 수 있습니다.

// 기본 사용법
FallbackView(
    description: "검색 결과가 없습니다."
)

// 모든 요소를 사용한 예시
FallbackView(
    image: { 
        Image.icon(.emptyBox)
            .resizable()
            .frame(width: 120, height: 120)
    },
    title: "데이터가 없습니다.",
    description: "새로운 항목을 추가해 보세요.",
    button: {
        Button(text: "추가하기") {
            // 버튼 동작
        }
    }
)

Topics

Initializers

init(image: (() -> any View)?, title: String?, description: String, button: (() -> any View)?)

FallbackView 컴포넌트를 초기화합니다.

  • Parameters

    ParameterDescription
    image상단에 표시할 이미지 뷰를 반환하는 클로저, 생략하면 기본값으로 nil 적용
    title강조되어 표시할 제목, 생략하면 기본값으로 nil 적용
    description상황을 설명하는 텍스트
    button하단에 표시할 버튼 뷰를 반환하는 클로저, 생략하면 기본값으로 nil 적용

  • Discussion

    원하는 레이아웃을 구성하기 위해 이미지, 제목, 설명, 버튼을 선택적으로 제공할 수 있습니다. 설명은 필수이며, 최대 2줄로 표시됩니다.

Instance Properties

var body: some View

뷰의 내용과 동작을 정의합니다.

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.