फ़्लोट करने वाला कार्रवाई बटन (एफ़एबी) मेन्यू

Material 3 में, फ़्लोट करने वाला कार्रवाई बटन (एफ़एबी) मेन्यू, एफ़एबी से खुलता है. इससे, मिलती-जुलती कई कार्रवाइयां दिखती हैं.

इससे मुख्य कार्रवाइयां ऐक्सेस की जा सकती हैं. साथ ही, यूज़र इंटरफ़ेस (यूआई) को साफ़-सुथरा रखा जा सकता है. इसके लिए, ज़रूरत न होने पर सेकंडरी कार्रवाइयों को छिपाया जा सकता है. साथ ही, स्पीड डायल और स्टैक किए गए छोटे एफ़एबी को बदला जा सकता है.

एफ़एबी मेन्यू का इस्तेमाल करना

  • यह एफ़एबी से खुलता है और स्क्रीन पर दो से छह मिलते-जुलते ऐक्शन दिखाता है.
  • सभी एफ़एबी साइज़ के लिए, एक ही एफ़एबी मेन्यू साइज़ का इस्तेमाल करता है.
  • इसका इस्तेमाल, बड़े किए गए एफ़एबी के साथ नहीं किया जाता.
  • इसमें प्राइमरी, सेकंडरी, और टर्शियरी कलर सेट इस्तेमाल किए जा सकते हैं.
एफ़एबी मेन्यू के तीन कलर सेट: प्राइमरी, सेकंडरी, और टर्शियरी.
पहली इमेज. एफ़एबी मेन्यू के कलर सेट: प्राइमरी, सेकंडरी, और टर्शियरी.

उदाहरण

एफ़एबी मेन्यू का सैंपल

FloatingActionButtonMenuItem कार्रवाइयों की सूची को बड़ा और छोटा करने के लिए, FloatingActionButtonMenu को ToggleFloatingActionButton के साथ जोड़ें. यहां दिए गए स्निपेट से, सूची को नीचे की ओर स्क्रोल करने पर, टॉगल एफ़एबी छिप जाता है. साथ ही, टैप करने पर मेन्यू बड़ा हो जाता है:

@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) },
                )
            }
        }
    }
}