Action area

모달 혹은 화면 하단 영역에서 메인, 대체, 보조 행동을 할 수 있는 다양한 레벨의 버튼 묶음을 제공합니다.

WantedActionArea

하단 액션 버튼 영역을 생성합니다. 버튼은 positive, negative, neutral 텍스트로 생성하며, 각 버튼에 클릭 콜백을 전달할 수 있습니다. 또한, Variant 속성을 활용하여 상단 영역에 부가적인 요소를 렌더링할 수 있습니다.

WantedActionArea(
    type = ActionAreaType.Strong,
    positive = "확인",
    onClickPositive = { /* 처리 */ },
    negative = "취소",
    onClickNegative = { /* 처리 */ },
    neutral = "건너뛰기",
    onClickNeutral = { /* 처리 */ }
)

Parameters

이름타입설명
typeActionAreaType액션 영역의 타입을 설정합니다.
positiveString메인(긍정) 액션 버튼의 텍스트입니다.
isEnablePositiveBoolean메인 액션 버튼의 활성화 여부입니다.
onClickPositive() -> Unit메인 액션 버튼 클릭 콜백입니다.
negativeString?서브(부정) 액션 버튼의 텍스트입니다.
isEnableNegativeBoolean서브 액션 버튼의 활성화 여부입니다.
neutralString?추가(중립) 액션 버튼의 텍스트입니다.
isEnableNeutralBoolean추가 액션 버튼의 활성화 여부입니다.
captionString?액션 영역 상단에 표시할 캡션입니다.
scrollableStateScrollableState?스크롤이 가능한 경우 상태를 전달합니다.
modifierModifierModifier를 설정합니다.
backgroundBoolean배경 그라데이션 표시 여부를 지정합니다.
safeAreaBooleanSafeArea를 적용할지 여부를 지정합니다.
dividerBoolean구분선 표시 여부를 지정합니다.
gradationColorColor배경 그라데이션 색상을 설정합니다.
onClickNegative(() -> Unit)?서브 액션 버튼 클릭 콜백입니다.
onClickNeutral(() -> Unit)?추가 액션 버튼 클릭 콜백입니다.
extra(@Composable () -> Unit)?추가적으로 표시할 컴포넌트입니다.

Overload

Slot을 활용하여 커스텀 버튼을 직접 전달할 수 있습니다. 버튼의 스타일 및 배치를 완전히 자유롭게 제어할 수 있습니다.

WantedActionArea(
    type = ActionAreaType.Strong,
    positive = {
        CustomMainButton(onClick = { ... })
    },
    negative = {
        CustomSecondaryButton(onClick = { ... })
    }
)
Parameters
이름타입설명
modifierModifierModifier를 설정합니다.
typeActionAreaType액션 영역의 타입을 설정합니다.
safeAreaBooleanSafeArea를 적용할지 여부를 지정합니다.
backgroundBoolean배경 그라데이션 표시 여부를 지정합니다.
gradationColorColor배경 그라데이션 색상을 설정합니다.
captionString?액션 영역 상단에 표시할 캡션입니다.
scrollableStateScrollableState?스크롤이 가능한 경우 상태를 전달합니다.
dividerBoolean구분선 표시 여부를 지정합니다.
positive(@Composable () -> Unit)메인(긍정) 액션 버튼 Slot입니다.
negative(@Composable (() -> Unit)?)서브(부정) 액션 버튼 Slot입니다.
neutral(@Composable (() -> Unit)?)추가(중립) 액션 버튼 Slot입니다.
extra(@Composable (() -> Unit)?)추가적으로 표시할 컴포넌트입니다.

Advanced

WantedActionAreaDefault

ActionArea에 필요한 버튼 기본 스타일을 정의한 데이터 클래스입니다. 각 버튼의 WantedButtonDefault를 개별적으로 설정할 수 있습니다.

Properties
이름타입설명
typeActionAreaType액션 영역 타입입니다.
positiveButtonDefaultWantedButtonDefault메인 액션 버튼 스타일을 설정합니다.
negativeButtonDefaultWantedButtonDefault서브 액션 버튼 스타일을 설정합니다.
neutralButtonDefaultWantedButtonDefault추가 액션 버튼 스타일을 설정합니다.

WantedActionAreaDefaults

WantedActionAreaDefault의 기본값을 제공하는 객체입니다. 액션 영역 타입에 따라 적절한 버튼 스타일을 자동으로 설정합니다.

getDefault

WantedActionAreaDefault의 기본 설정을 생성합니다. 액션 영역 타입에 따라 positive, negative, neutral 버튼의 기본 스타일을 자동으로 설정합니다. 각 버튼의 스타일을 개별적으로 커스터마이징할 수도 있습니다.

val config = WantedActionAreaDefaults.getDefault(
    type = ActionAreaType.Strong
)
Parameters
이름타입설명
typeActionAreaType액션 영역의 타입입니다. 기본값은 ActionAreaType.Strong입니다.
positiveButtonDefaultWantedButtonDefault메인 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다.
negativeButtonDefaultWantedButtonDefault서브 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다.
neutralButtonDefaultWantedButtonDefault추가 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다.

Return
타입설명
WantedActionAreaDefault설정된 WantedActionAreaDefault 인스턴스를 반환합니다.

Enum

ActionAreaType

설명
Strong강조된 액션 영역입니다.
Neutral중립적인 액션 영역입니다.
Cancel취소 중심의 액션 영역입니다.

© 2026 Wanted Lab, Inc.