כפתור מפוצל

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

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

שימוש בלחצנים מפוצלים

  • פותח תפריט שנותן למשתמשים אפשרויות משניות שקשורות לפעולה הראשית.
  • הוא פועל לבד או לצד כפתורים רגילים וכפתורי סמלים.
  • בדרך כלל פותח תפריט, אבל אפשר להתאים אותו אישית כדי לפתוח רכיבים אחרים, כמו כרטיסים.
  • תומך באותם חמישה גדלים כמו כפתורים וכפתורי סמלים: קטן מאוד (XS), קטן (S), בינוני (M), גדול (L) וגדול מאוד (XL).
כפתורים מפוצלים בגדלים ובסגנונות צבע שונים.
תרשים 1. כפתורים מפוצלים בגדלים ובסגנונות צבע שונים.

דוגמאות

כפתור מפוצל מלא

כפתור מפוצל מלא הוא גרסה מודגשת שמשמשת לפעולות חשובות או סופיות. קטע הקוד הבא מטמיע כפתור מפוצל מלא באמצעות SplitButtonLayout עם SplitButtonDefaults.LeadingButton ו-SplitButtonDefaults.TrailingButton:

@Composable
fun FilledSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.LeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}

כפתור מפוצל בצבע אחד

כפתור מפוצל בצבע אחד הוא גרסה של כפתור מפוצל עם הדגשה בינונית. בקטע הקוד הבא נעשה שימוש ב-SplitButtonDefaults.TonalLeadingButton וב-SplitButtonDefaults.TonalTrailingButton בתוך SplitButtonLayout:

@Composable
fun TonalSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.TonalLeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TonalTrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}