Fallback view

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

WantedFallbackView

제목, 설명, 버튼을 조합하여 비어 있는 상태를 안내하는 컴포넌트입니다. 주로 데이터가 없거나 결과가 없을 때 사용자에게 피드백을 제공하는 용도로 사용됩니다. 제목, 설명, 버튼을 선택적으로 구성할 수 있으며, 버튼 클릭 시 콜백을 전달할 수 있습니다. 버튼은 Assistive 색상만 사용하며, 좌우 여백은 호출하는 화면에서 배치합니다. 상하 여백은 [padding] 으로 지정합니다.

WantedFallbackView(
    padding = WantedFallbackPadding.Normal,
    heading = "데이터가 없습니다.",
    description = "새로운 데이터를 추가해보세요.",
    main = "추가하기",
    onClickMain = { /* 버튼 클릭 처리 */ }
)

Parameters

이름타입설명
modifierModifier외형 및 배치를 조정하는 Modifier입니다.
paddingWantedFallbackPadding콘텐츠 상하 여백을 지정합니다 (Normal, Compact).
buttonVariantWantedFallbackButtonVariant버튼 배치 방식을 지정합니다 (Single, Horizontal, Vertical).
headingString?상단에 강조 텍스트(제목)를 표시합니다.
descriptionString?제목 아래에 설명 텍스트를 표시합니다. 최대 두 줄까지만 표시됩니다.
mainString?메인 액션 버튼에 표시될 텍스트입니다. null일 경우 버튼은 렌더링되지 않습니다.
alternativeString?대체 액션 버튼에 표시될 텍스트입니다. null일 경우 버튼은 렌더링되지 않습니다.
onClickMain() -> Unit메인 액션 버튼 클릭 시 호출되는 콜백입니다.
onClickAlternative() -> Unit대체 액션 버튼 클릭 시 호출되는 콜백입니다.

Advanced

이미지

디자인 4.0.0 에서 이미지 슬롯이 제거되어 더 이상 사용하지 않습니다. 기존 화면 호환을 위해서만 유지하며, 이미지 없는 오버로드로 이관합니다.

Parameters
이름타입설명
image(@Composable () -> Unit)텍스트 위에 표시될 이미지 컴포넌트입니다.
modifierModifier외형 및 배치를 조정하는 Modifier입니다.
buttonVariantWantedFallbackButtonVariant버튼 배치 방식을 지정합니다 (Single, Horizontal, Vertical).
headingString?상단에 강조 텍스트(제목)를 표시합니다.
descriptionString?제목 아래에 설명 텍스트를 표시합니다. 최대 두 줄까지만 표시됩니다.
mainString?메인 액션 버튼에 표시될 텍스트입니다. null일 경우 버튼은 렌더링되지 않습니다.
alternativeString?대체 액션 버튼에 표시될 텍스트입니다. null일 경우 버튼은 렌더링되지 않습니다.
onClickMain() -> Unit메인 액션 버튼 클릭 시 호출되는 콜백입니다.
onClickAlternative() -> Unit대체 액션 버튼 클릭 시 호출되는 콜백입니다.

Enum

WantedFallbackPadding

© 2026 Wanted Lab, Inc.