Bouton de répartition

Un bouton partagé définit un groupe de deux boutons, où le bouton principal effectue une action principale et le bouton secondaire ouvre un ensemble secondaire d'options contextuelles.

Lorsqu'il est activé, le bouton de menu de fin fait pivoter son icône et change de forme. Les boutons partagés peuvent être placés seuls ou à côté d'autres boutons de même taille.

Utiliser des boutons partagés

  • Ouvre un menu permettant de proposer aux utilisateurs des options secondaires liées à l'action principale.
  • Il peut être utilisé seul ou avec des boutons standards et des boutons d'icône.
  • Ouvre généralement un menu, mais peut être personnalisé pour ouvrir d'autres composants tels que des fiches.
  • Prend en charge les cinq mêmes tailles que les boutons et les boutons d'icône : très petit (XS), petit (S), moyen (M), grand (L) et très grand (XL).
Boutons partagés de différentes tailles et couleurs.
Figure 1. Boutons de fractionnement de différentes tailles et couleurs.

Exemples

Bouton partagé rempli

Un bouton partagé plein est la variante à forte mise en avant utilisée pour les actions importantes ou finales. L'extrait de code suivant implémente un bouton partagé plein à l'aide de SplitButtonLayout avec SplitButtonDefaults.LeadingButton et 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,
                )
            }
        },
    )
}

Bouton partagé tonal

Un bouton de répartition tonal est la variante à intensité moyenne d'un bouton de répartition. L'extrait de code suivant utilise SplitButtonDefaults.TonalLeadingButton et SplitButtonDefaults.TonalTrailingButton dans 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,
                )
            }
        },
    )
}