하단 액션 버튼 영역을 생성합니다.
버튼은 positive, negative, neutral 텍스트로 생성하며, 각 버튼에 클릭 콜백을 전달할 수 있습니다.
또한, Variant 속성을 활용하여 상단 영역에 부가적인 요소를 렌더링할 수 있습니다.
WantedActionArea(
type = ActionAreaType.Strong,
positive = "확인",
onClickPositive = { },
negative = "취소",
onClickNegative = { },
neutral = "건너뛰기",
onClickNeutral = { }
)
| 이름 | 타입 | 설명 |
|---|
type | ActionAreaType | 액션 영역의 타입을 설정합니다. |
positive | String | 메인(긍정) 액션 버튼의 텍스트입니다. |
isEnablePositive | Boolean | 메인 액션 버튼의 활성화 여부입니다. |
onClickPositive | () -> Unit | 메인 액션 버튼 클릭 콜백입니다. |
negative | String? | 서브(부정) 액션 버튼의 텍스트입니다. |
isEnableNegative | Boolean | 서브 액션 버튼의 활성화 여부입니다. |
neutral | String? | 추가(중립) 액션 버튼의 텍스트입니다. |
isEnableNeutral | Boolean | 추가 액션 버튼의 활성화 여부입니다. |
caption | String? | 액션 영역 상단에 표시할 캡션입니다. |
scrollableState | ScrollableState? | 스크롤이 가능한 경우 상태를 전달합니다. |
modifier | Modifier | Modifier를 설정합니다. |
background | Boolean | 배경 그라데이션 표시 여부를 지정합니다. |
safeArea | Boolean | SafeArea를 적용할지 여부를 지정합니다. |
divider | Boolean | 구분선 표시 여부를 지정합니다. |
gradationColor | Color | 배경 그라데이션 색상을 설정합니다. |
onClickNegative | (() -> Unit)? | 서브 액션 버튼 클릭 콜백입니다. |
onClickNeutral | (() -> Unit)? | 추가 액션 버튼 클릭 콜백입니다. |
extra | (@Composable () -> Unit)? | 추가적으로 표시할 컴포넌트입니다. |
Slot을 활용하여 커스텀 버튼을 직접 전달할 수 있습니다.
버튼의 스타일 및 배치를 완전히 자유롭게 제어할 수 있습니다.
WantedActionArea(
type = ActionAreaType.Strong,
positive = {
CustomMainButton(onClick = { ... })
},
negative = {
CustomSecondaryButton(onClick = { ... })
}
)
Parameters
| 이름 | 타입 | 설명 |
|---|
modifier | Modifier | Modifier를 설정합니다. |
type | ActionAreaType | 액션 영역의 타입을 설정합니다. |
safeArea | Boolean | SafeArea를 적용할지 여부를 지정합니다. |
background | Boolean | 배경 그라데이션 표시 여부를 지정합니다. |
gradationColor | Color | 배경 그라데이션 색상을 설정합니다. |
caption | String? | 액션 영역 상단에 표시할 캡션입니다. |
scrollableState | ScrollableState? | 스크롤이 가능한 경우 상태를 전달합니다. |
divider | Boolean | 구분선 표시 여부를 지정합니다. |
positive | (@Composable () -> Unit) | 메인(긍정) 액션 버튼 Slot입니다. |
negative | (@Composable (() -> Unit)?) | 서브(부정) 액션 버튼 Slot입니다. |
neutral | (@Composable (() -> Unit)?) | 추가(중립) 액션 버튼 Slot입니다. |
extra | (@Composable (() -> Unit)?) | 추가적으로 표시할 컴포넌트입니다. |
ActionArea에 필요한 버튼 기본 스타일을 정의한 데이터 클래스입니다.
각 버튼의 WantedButtonDefault를 개별적으로 설정할 수 있습니다.
Properties
| 이름 | 타입 | 설명 |
|---|
type | ActionAreaType | 액션 영역 타입입니다. |
positiveButtonDefault | WantedButtonDefault | 메인 액션 버튼 스타일을 설정합니다. |
negativeButtonDefault | WantedButtonDefault | 서브 액션 버튼 스타일을 설정합니다. |
neutralButtonDefault | WantedButtonDefault | 추가 액션 버튼 스타일을 설정합니다. |
WantedActionAreaDefault의 기본값을 제공하는 객체입니다.
액션 영역 타입에 따라 적절한 버튼 스타일을 자동으로 설정합니다.
WantedActionAreaDefault의 기본 설정을 생성합니다.
액션 영역 타입에 따라 positive, negative, neutral 버튼의 기본 스타일을 자동으로 설정합니다.
각 버튼의 스타일을 개별적으로 커스터마이징할 수도 있습니다.
val config = WantedActionAreaDefaults.getDefault(
type = ActionAreaType.Strong
)
Parameters
| 이름 | 타입 | 설명 |
|---|
type | ActionAreaType | 액션 영역의 타입입니다. 기본값은 ActionAreaType.Strong입니다. |
positiveButtonDefault | WantedButtonDefault | 메인 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다. |
negativeButtonDefault | WantedButtonDefault | 서브 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다. |
neutralButtonDefault | WantedButtonDefault | 추가 액션 버튼의 기본 스타일입니다. 타입에 따라 자동 설정됩니다. |
Return
| 타입 | 설명 |
|---|
| WantedActionAreaDefault | 설정된 WantedActionAreaDefault 인스턴스를 반환합니다. |
| 값 | 설명 |
|---|
Strong | 강조된 액션 영역입니다. |
Neutral | 중립적인 액션 영역입니다. |
Cancel | 취소 중심의 액션 영역입니다. |