Action area

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

WantedActionArea

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

WantedActionArea(
    type = ActionAreaType.Strong,
    main = "확인",
    onClickMain = { /* 처리 */ },
    alternative = "취소",
    onClickAlternative = { /* 처리 */ },
    sub = "건너뛰기",
    onClickSub = { /* 처리 */ }
)

Parameters

이름타입설명
typeActionAreaType액션 영역의 타입을 설정합니다.
mainString메인 액션 버튼의 텍스트입니다.
modifierModifierModifier를 설정합니다.
isEnableMainBoolean메인 액션 버튼의 활성화 여부입니다.
onClickMain() -> Unit메인 액션 버튼 클릭 콜백입니다.
alternativeString?대체 액션 버튼의 텍스트입니다.
isEnableAlternativeBoolean대체 액션 버튼의 활성화 여부입니다.
subString?보조 액션 버튼의 텍스트입니다.
isEnableSubBoolean보조 액션 버튼의 활성화 여부입니다.
captionString?액션 영역 상단에 표시할 캡션입니다.
captionIconInt?캡션 텍스트 앞에 표시할 아이콘 리소스입니다. 기본값은 아이콘 없음이며, 권장 아이콘은 [WantedActionAreaDefaults.CAPTION_ICON]입니다.
scrollableStateScrollableState?스크롤이 가능한 경우 상태를 전달합니다.
backgroundBoolean배경 그라데이션 표시 여부를 지정합니다.
safeAreaBooleanSafeArea를 적용할지 여부를 지정합니다.
dividerBoolean구분선 표시 여부를 지정합니다. extra가 있을 때만 표시됩니다.
backgroundColorColorExtra·버튼 영역의 배경색이자 sticky 그라데이션의 색상입니다. 그라데이션이 꺼져 있고 extra 도 없으면 배경을 칠하지 않습니다.
onClickAlternative(() -> Unit)?대체 액션 버튼 클릭 콜백입니다.
onClickSub(() -> Unit)?보조 액션 버튼 클릭 콜백입니다.
extra(@Composable () -> Unit)?추가적으로 표시할 컴포넌트입니다.

Overload

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

WantedActionArea(
    type = ActionAreaType.Strong,
    main = {
        CustomMainButton(onClick = { ... })
    },
    alternative = {
        CustomSecondaryButton(onClick = { ... })
    }
)
Parameters
이름타입설명
modifierModifierModifier를 설정합니다.
typeActionAreaType액션 영역의 타입을 설정합니다.
safeAreaBooleanSafeArea를 적용할지 여부를 지정합니다.
backgroundBoolean배경 그라데이션 표시 여부를 지정합니다.
backgroundColorColorExtra·버튼 영역의 배경색이자 sticky 그라데이션의 색상입니다. 그라데이션이 꺼져 있고 extra 도 없으면 배경을 칠하지 않습니다.
captionString?액션 영역 상단에 표시할 캡션입니다.
captionIconInt?캡션 텍스트 앞에 표시할 아이콘 리소스입니다. 기본값은 아이콘 없음이며, 권장 아이콘은 [WantedActionAreaDefaults.CAPTION_ICON]입니다.
scrollableStateScrollableState?스크롤이 가능한 경우 상태를 전달합니다.
dividerBoolean구분선 표시 여부를 지정합니다. extra가 있을 때만 표시됩니다.
main(@Composable () -> Unit)메인 액션 버튼 Slot입니다.
alternative(@Composable (() -> Unit)?)대체 액션 버튼 Slot입니다.
sub(@Composable (() -> Unit)?)보조 액션 버튼 Slot입니다.
extra(@Composable (() -> Unit)?)추가적으로 표시할 컴포넌트입니다.

Advanced

Modifier.actionAreaBackground

Extra 영역과 버튼 영역에 배경색을 칠합니다. 그라디언트가 꺼져 있고 Extra 도 없을 때만 배경을 걷어 페이지 배경이 그대로 비치게 둡니다(iOS 와 동일). 배경을 칠하지 않으면 다크모드에서 Extra 영역이 페이지 배경색으로 보이고, sticky 일 때 그라디언트 끝에 경계선이 생깁니다.

Parameters
이름타입설명
backgroundBoolean배경 그라데이션 표시 여부입니다.
hasExtraBooleanExtra 슬롯이 있는지 여부입니다.
backgroundColorColor칠할 배경색입니다.

Return
타입설명
Modifier배경이 적용된 Modifier 입니다.

WantedActionAreaDefault

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

Properties
이름타입설명
typeActionAreaType액션 영역 타입입니다.
mainButtonDefaultWantedButtonDefault메인 액션 버튼 스타일을 설정합니다.
alternativeButtonDefaultWantedButtonDefault대체 액션 버튼 스타일을 설정합니다.
subButtonDefaultWantedButtonDefault보조 액션 버튼 스타일을 설정합니다.

WantedActionAreaDefaults

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

Properties
이름타입설명
CAPTION_ICONInt캡션 아이콘을 사용할 때 권장되는 기본 아이콘(@DrawableRes)입니다. 캡션 아이콘은 기본적으로 표시되지 않으며, 아이콘이 필요할 때 WantedActionArea 의 captionIcon 에 이 값을 전달합니다.

getDefault

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

val config = WantedActionAreaDefaults.getDefault(
    type = ActionAreaType.Strong
)
Parameters
이름타입설명
typeActionAreaType액션 영역의 타입입니다. 기본값은 ActionAreaType.Strong입니다.
mainButtonDefaultWantedButtonDefault메인 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다.
alternativeButtonDefaultWantedButtonDefault대체 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다.
subButtonDefaultWantedButtonDefault보조 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다.

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

Enum

ActionAreaType

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

© 2026 Wanted Lab, Inc.