Fallback view

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

WantedFallback

이미지, 제목, 설명, 버튼 등을 조합하여 비어 있는 상태를 안내하는 컴포넌트입니다. 주로 데이터가 없거나 결과가 없을 때 사용자에게 피드백을 제공하는 용도로 사용됩니다. 이미지, 제목, 설명, 버튼을 선택적으로 구성할 수 있으며, 버튼 클릭 시 콜백을 전달할 수 있습니다.

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

Parameters

이름타입설명
modifierModifier외형 및 배치를 조정하는 Modifier입니다.
buttonVariantWantedFallbackButtonVariant버튼 배치 방식을 지정합니다 (Single, Horizontal, Vertical).
headingString?상단에 강조 텍스트(제목)를 표시합니다.
descriptionString?제목 아래에 설명 텍스트를 표시합니다. 최대 두 줄까지만 표시됩니다.
positiveString?긍정 버튼에 표시될 텍스트입니다. null일 경우 버튼은 렌더링되지 않습니다.
negativeString?부정 버튼에 표시될 텍스트입니다. null일 경우 버튼은 렌더링되지 않습니다.
positiveColorButtonType긍정 버튼의 색상 타입입니다. 기본값은 ASSISTIVE입니다.
negativeColorButtonType부정 버튼의 색상 타입입니다. 기본값은 ASSISTIVE입니다.
image(@Composable () -> Unit)?중앙에 표시될 이미지 컴포넌트입니다.
onClickPositive() -> Unit긍정 버튼 클릭 시 호출되는 콜백입니다.
onClickNegative() -> Unit부정 버튼 클릭 시 호출되는 콜백입니다.

© 2026 Wanted Lab, Inc.