버튼 그룹

버튼 그룹은 버튼을 정리하고 버튼과 아이콘 버튼에 조정된 모양, 모션, 너비 변경사항을 적용하여 버튼 간의 상호작용을 추가합니다. 버튼 그룹에는 두 가지 변형이 있습니다.

  1. 표준 버튼 그룹: 인접한 버튼 간에 상호작용을 추가하여 버튼을 누르면 서로 반응합니다.
  2. 연결된 버튼 그룹: 사용자가 페이지에서 옵션을 선택하거나, 뷰를 전환하거나, 요소를 정렬할 수 있도록 전환 버튼을 그룹화합니다.
왼쪽의 표준 버튼 그룹과 오른쪽의 연결된 버튼 그룹
그림 1. 표준 버튼 그룹(1, 왼쪽) 및 연결된 버튼 그룹(2, 오른쪽)

버튼 그룹 사용

  • 버튼을 누르거나 선택할 때 도형 변형을 적용합니다.
  • 연결된 버튼 그룹이 분할된 버튼을 대체합니다.
  • 모든 버튼 크기(초소형(XS), 소형(S), 중형(M), 대형(L), 초대형(XL))에서 작동합니다.
  • 단일 선택, 다중 선택, 선택 필수 패턴을 지원합니다.
다양한 모양과 크기의 버튼이 포함된 버튼 그룹
그림 2. 다양한 모양과 크기의 버튼이 포함된 버튼 그룹

표준 버튼 그룹

ButtonGroup 컴포저블을 사용하여 버튼을 가로 순서로 배치합니다. 이 컴포저블은 공간이 제한된 경우 누른 항목을 펼치고, 인접한 항목을 압축하고, 추가 항목을 더보기 메뉴로 이동합니다. 버튼 그룹은 두 번째 줄로 줄바꿈되지 않고 한 줄에 유지되어야 합니다.

다음 스니펫은 더보기 메뉴 표시기가 있는 표준 버튼 그룹을 구현하는 방법을 보여줍니다.

@Composable
fun ButtonGroupSample() {
    val numButtons = 10
    ButtonGroup(
        overflowIndicator = { menuState ->
            ButtonGroupDefaults.OverflowIndicator(menuState = menuState)
        }
    ) {
        for (i in 0 until numButtons) {
            clickableItem(onClick = {}, label = "$i")
        }
    }
}

연결된 버튼 그룹

ToggleButton 컴포저블과 ButtonGroupDefaults 연결된 도형으로 빌드된 단일 선택 또는 다중 선택 패턴에 연결된 버튼 그룹을 사용합니다.

연결된 버튼 그룹 동작입니다.
그림 3. 반응형 연결 버튼 그룹 동작

하나 선택

사용자가 상호 배타적인 세트에서 하나의 옵션을 선택하는 경우 단일 선택 연결 버튼 그룹을 사용합니다. 다음 스니펫은 ToggleButton 및 Role.RadioButton를 사용하여 단일 선택 연결 버튼 그룹을 구현합니다.

@Composable
fun SingleSelectConnectedButtonGroupSample() {
    val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home")
    val unCheckedIcons =
        listOf(
            AppIcons.Work,
            AppIcons.Restaurant,
            AppIcons.Coffee,
            AppIcons.Search,
            AppIcons.Home,
        )
    val checkedIcons =
        listOf(
            AppIcons.WorkFilled,
            AppIcons.Restaurant,
            AppIcons.CoffeeFilled,
            AppIcons.Search,
            AppIcons.HomeFilled,
        )
    var selectedIndex by remember { mutableIntStateOf(0) }

    FlexBox(
        modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(),
        config = {
            direction(FlexDirection.Row)
            wrap(FlexWrap.Wrap)
            columnGap(ButtonGroupDefaults.ConnectedSpaceBetween)
            rowGap(2.dp)
        },
    ) {
        options.forEachIndexed { index, label ->
            ToggleButton(
                checked = selectedIndex == index,
                onCheckedChange = { selectedIndex = index },
                shapes =
                    when (index) {
                        0 -> ButtonGroupDefaults.connectedLeadingButtonShapes()
                        options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes()
                        else -> ButtonGroupDefaults.connectedMiddleButtonShapes()
                    },
                modifier = Modifier.semantics { role = Role.RadioButton },
            ) {
                Icon(
                    painter =
                        rememberVectorPainter(
                            if (selectedIndex == index) checkedIcons[index] else unCheckedIcons[index]
                        ),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing))
                Text(label)
            }
        }
    }
}

다중 선택

사용자가 0개 이상의 옵션을 독립적으로 전환할 수 있는 경우 다중 선택 연결 버튼 그룹을 사용합니다. 다음 스니펫은 ToggleButton 및 mutableStateListOf를 사용하여 다중 선택 연결 버튼 그룹을 구현합니다.

@Composable
fun MultiSelectConnectedButtonGroupSample() {
    val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home")
    val unCheckedIcons =
        listOf(
            AppIcons.Work,
            AppIcons.Restaurant,
            AppIcons.Coffee,
            AppIcons.Search,
            AppIcons.Home,
        )
    val checkedIcons =
        listOf(
            AppIcons.WorkFilled,
            AppIcons.Restaurant,
            AppIcons.CoffeeFilled,
            AppIcons.Search,
            AppIcons.HomeFilled,
        )
    val checked = remember { mutableStateListOf(false, false, false, false, false) }

    FlexBox(
        modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(),
        config = {
            direction(FlexDirection.Row)
            wrap(FlexWrap.Wrap)
            columnGap(ButtonGroupDefaults.ConnectedSpaceBetween)
            rowGap(2.dp)
        },
    ) {
        options.forEachIndexed { index, label ->
            ToggleButton(
                checked = checked[index],
                onCheckedChange = { checked[index] = it },
                shapes =
                    when (index) {
                        0 -> ButtonGroupDefaults.connectedLeadingButtonShapes()
                        options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes()
                        else -> ButtonGroupDefaults.connectedMiddleButtonShapes()
                    },
            ) {
                Icon(
                    painter =
                        rememberVectorPainter(
                            if (checked[index]) checkedIcons[index] else unCheckedIcons[index]
                        ),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing))
                Text(label)
            }
        }
    }
}