Nhóm nút

Nhóm nút sắp xếp các nút và thêm hoạt động tương tác giữa các nút bằng cách áp dụng các thay đổi về hình dạng, chuyển động và chiều rộng cho các nút và nút biểu tượng. Có hai biến thể của nhóm nút:

  1. Nhóm nút tiêu chuẩn: Thêm hoạt động tương tác giữa các nút liền kề để chúng phản hồi lẫn nhau khi được nhấn.
  2. Nhóm nút được kết nối: Nhóm các nút bật/tắt để cho phép người dùng chọn các lựa chọn, chuyển đổi chế độ xem hoặc sắp xếp các phần tử trên một trang.
Nhóm nút tiêu chuẩn ở bên trái và nhóm nút được kết nối ở bên phải.
Hình 1. Nhóm nút tiêu chuẩn (1, bên trái) và nhóm nút được kết nối (2, bên phải).

Sử dụng nhóm nút

  • Áp dụng hiệu ứng biến đổi hình dạng khi người dùng nhấn hoặc chọn nút.
  • Nhóm nút được kết nối thay thế các nút được phân đoạn.
  • Hoạt động với tất cả kích thước nút: cực nhỏ (XS), nhỏ (S), trung bình (M), lớn (L) và cực lớn (XL).
  • Hỗ trợ các mẫu chọn một, chọn nhiều và bắt buộc chọn.
Nhóm nút chứa các nút có nhiều hình dạng và kích thước.
Hình 2. Nhóm nút chứa các nút có nhiều hình dạng và kích thước.

Nhóm nút tiêu chuẩn

Sử dụng thành phần kết hợp ButtonGroup để đặt các nút theo trình tự ngang, mở rộng mục được nhấn, thu gọn các mục lân cận và di chuyển các mục bổ sung vào trình đơn mục bổ sung khi không gian bị giới hạn. Các nhóm nút nên nằm trên một dòng duy nhất thay vì xuống dòng thứ hai.

Đoạn mã sau đây minh hoạ cách triển khai một nhóm nút tiêu chuẩn có chỉ báo trình đơn mục bổ sung:

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

Nhóm nút đã kết nối

Sử dụng các nhóm nút được kết nối cho các mẫu chọn một hoặc nhiều mục được tạo bằng thành phần kết hợp ToggleButton và hình dạng được kết nối ButtonGroupDefaults.

Hành vi của nhóm nút được kết nối.
Hình 3. Hành vi của nhóm nút được kết nối thích ứng.

Chọn một câu trả lời

Sử dụng nhóm nút được kết nối một lựa chọn khi người dùng chọn một lựa chọn trong một nhóm loại trừ lẫn nhau. Đoạn mã sau đây triển khai một nhóm nút được kết nối có một lựa chọn bằng cách sử dụng ToggleButton và 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)
            }
        }
    }
}

Chọn nhiều câu trả lời

Sử dụng nhóm nút được kết nối nhiều lựa chọn khi người dùng có thể bật/tắt không hoặc nhiều lựa chọn một cách độc lập. Đoạn mã sau đây triển khai một nhóm nút được kết nối nhiều lựa chọn bằng cách sử dụng ToggleButton và 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)
            }
        }
    }
}