Kayan işlem düğmesi (FAB) menüsü

Kayan işlem düğmesi (FAB) menüsü, Material 3'te birden fazla ilgili işlemi görüntülemek için FAB'den açılır.

Bu sayede, önemli işlemler erişilebilir durumda kalırken ikincil işlemler ihtiyaç duyulmadığında gizlenerek kullanıcı arayüzünün temiz kalması sağlanır. Bu yaklaşım, hızlı aramaların ve üst üste yığılmış küçük FAB'lerin yerini alır.

FAB menüsünü kullanma

  • FAB'den açılır ve ekranda kayan iki ila altı ilgili işlemi gösterir.
  • Tüm FAB boyutlarında tek bir FAB menü boyutu kullanır.
  • Genişletilmiş FAB'lerle kullanılmaz.
  • Birincil, ikincil ve üçüncül renk gruplarını destekler.
Üç FAB menü renk grubu: birincil, ikincil ve üçüncül.
Şekil 1. FAB menüsü renk grupları: birincil, ikincil ve üçüncül.

Örnekler

FAB menüsü örneği

FloatingActionButtonMenuItem işlemlerinin listesini genişletmek ve daraltmak için FloatingActionButtonMenu ile ToggleFloatingActionButton tuşlarını birlikte kullanın. Aşağıdaki snippet, bir listede aşağı kaydırırken açma/kapatma FAB'ını gizler ve dokunulduğunda menüyü genişletir:

@Composable
fun FloatingActionButtonMenuSample() {
    val listState = rememberLazyListState()
    val fabVisible by remember { derivedStateOf { listState.firstVisibleItemIndex == 0 } }

    Box {
        LazyColumn(state = listState, modifier = Modifier.fillMaxSize()) {
            for (index in 0 until 100) {
                item { Text(text = "List item - $index", modifier = Modifier.padding(24.dp)) }
            }
        }

        val items =
            listOf(
                AppIcons.Message to "Reply",
                AppIcons.People to "Reply all",
                AppIcons.Contacts to "Forward",
                AppIcons.Snooze to "Snooze",
                AppIcons.Archive to "Archive",
                AppIcons.Label to "Label",
            )

        var fabMenuExpanded by rememberSaveable { mutableStateOf(false) }

        FloatingActionButtonMenu(
            modifier = Modifier.align(Alignment.BottomEnd),
            expanded = fabMenuExpanded,
            button = {
                ToggleFloatingActionButton(
                    modifier =
                        Modifier.semantics {
                            traversalIndex = -1f
                            stateDescription = if (fabMenuExpanded) "Expanded" else "Collapsed"
                            contentDescription = "Toggle menu"
                        }
                            .animateFloatingActionButton(
                                visible = fabVisible || fabMenuExpanded,
                                alignment = Alignment.BottomEnd,
                            ),
                    checked = fabMenuExpanded,
                    onCheckedChange = { fabMenuExpanded = !fabMenuExpanded },
                ) {
                    val imageVector by remember {
                        derivedStateOf { if (checkedProgress > 0.5f) AppIcons.Close else AppIcons.Add }
                    }
                    Icon(
                        painter = rememberVectorPainter(imageVector),
                        contentDescription = null,
                        modifier = Modifier.animateIcon({ checkedProgress }),
                    )
                }
            },
        ) {
            items.forEach { item ->
                FloatingActionButtonMenuItem(
                    onClick = { fabMenuExpanded = false },
                    icon = { Icon(painter = rememberVectorPainter(item.first), contentDescription = null) },
                    text = { Text(text = item.second) },
                )
            }
        }
    }
}