Bölünmüş düğme, iki düğmeli bir grubu tanımlar. Bu grupta, baştaki düğme birincil işlemi gerçekleştirir, sondaki düğme ise bağlamsal olarak alakalı ikincil seçenekler grubunu açar.
Etkinleştirildiğinde, sondaki menü düğmesi simgesini döndürür ve şeklini değiştirir. Bölünmüş düğmeler tek başına veya aynı boyuttaki diğer düğmelerle birlikte yerleştirilebilir.
Bölünmüş düğmeleri kullanma
- Kullanıcılara birincil işlemle ilgili ikincil seçenekler sunan bir menü açar.
- Tek başına veya standart düğmeler ve simge düğmeleriyle birlikte kullanılabilir.
- Genellikle bir menü açar ancak kartlar gibi diğer bileşenleri açacak şekilde özelleştirilebilir.
- Düğmeler ve simge düğmeleriyle aynı beş boyutu destekler: çok küçük (XS), küçük (S), orta (M), büyük (L) ve çok büyük (XL).
Örnekler
Dolgulu bölünmüş düğme
Dolgulu bölünmüş düğme, önemli veya son işlemler için kullanılan yüksek vurgulu varyanttır. Aşağıdaki snippet, SplitButtonDefaults.LeadingButton ve SplitButtonDefaults.TrailingButton ile SplitButtonLayout kullanarak doldurulmuş bir bölünmüş düğme uygular:
@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, ) } }, ) }
Tonlu bölünmüş düğme
Tonlu bölünmüş düğme, bölünmüş düğmenin orta vurgulu varyantıdır. Aşağıdaki snippet, SplitButtonLayout içinde SplitButtonDefaults.TonalLeadingButton ve SplitButtonDefaults.TonalTrailingButton kullanır:
@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, ) } }, ) }