קבוצות לחצנים

קבוצות של כפתורים מארגנות את הכפתורים ומוסיפות אינטראקציות ביניהם על ידי החלת שינויים מתואמים בצורה, בתנועה וברוחב על כפתורים וכפתורי סמלים. יש שתי גרסאות של קבוצות כפתורים:

  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)
            }
        }
    }
}

בחירה מרובה

השתמשו בקבוצת כפתורים מחוברים עם בחירה מרובה כשהמשתמש יכול להפעיל או להשבית אפס אפשרויות או יותר באופן עצמאי. קטע הקוד הבא מטמיע קבוצת לחצנים מקושרים לבחירה מרובה באמצעות 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)
            }
        }
    }
}