منو دکمه کنش شناور (FAB) از FAB باز میشود تا چندین کنش مرتبط را در Material 3 نمایش دهد.
این کار باعث میشود کنشهای کلیدی دردسترس بمانند و درعینحال با پنهان کردن کنشهای ثانویه در مواقعی که نیاز نیستند، میانای کاربر تمیز بماند و جایگزین شمارهگیریهای سریع و دکمههای کنش شناور کوچک پشتهای شود.
استفاده از منوِ FAB
- از FAB باز میشود تا دو تا شش کنش مرتبط را بهصورت شناور در صفحه نشان دهد.
- از یک اندازه منو FAB در همه اندازههای FAB استفاده میکند.
- با دکمههای کنش شناور گسترده استفاده نمیشود.
- از مجموعههای رنگ اصلی، فرعی، و سوم پشتیبانی میکند.
مثالها
نمونه منو دکمه کنش شناور
FloatingActionButtonMenu را با ToggleFloatingActionButton جفت کنید تا
فهرست کنشهای FloatingActionButtonMenuItem را ازهم باز و جمع کنید. قطعه کد زیر دکمه FAB تغییر وضعیت را هنگام پیمایش فهرست به پایین پنهان میکند و منو را هنگام تکضرب زدن ازهم باز میکند:
@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) }, ) } } } }