Przycisk dzielony definiuje grupę 2 przycisków, w której przycisk wiodący wykonuje działanie główne, a przycisk końcowy otwiera dodatkowy zestaw opcji powiązanych kontekstowo.
Po aktywacji przycisk menu na końcu zmienia kształt i obraca ikonę. Przyciski dzielone można umieszczać samodzielnie lub obok innych przycisków o tym samym rozmiarze.
Korzystanie z przycisków dzielonych
- Otwiera menu z dodatkowymi opcjami związanymi z głównym działaniem.
- Działa samodzielnie lub razem ze standardowymi przyciskami i przyciskami z ikonami.
- Zwykle otwiera menu, ale można go dostosować, aby otwierał inne komponenty, takie jak karty.
- Obsługuje te same 5 rozmiarów co przyciski i przyciski ikon: bardzo mały (XS), mały (S), średni (M), duży (L) i bardzo duży (XL).
Przykłady
Wypełniony przycisk dzielony
Wypełniony przycisk dzielony to wariant o wysokim kontraście, który jest używany do ważnych lub ostatecznych działań. Poniższy fragment kodu implementuje wypełniony przycisk dzielony za pomocą funkcji SplitButtonLayout z parametrami SplitButtonDefaults.LeadingButton i 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, ) } }, ) }
Przycisk podziału tonalnego
Przycisk podziału z kolorem tonalnym to wariant przycisku podziału o średnim poziomie wyróżnienia. Ten fragment kodu używa SplitButtonDefaults.TonalLeadingButton i SplitButtonDefaults.TonalTrailingButton w 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, ) } }, ) }