قائمة زر الإجراء الرئيسي (FAB)

تُفتح قائمة زر الإجراء الرئيسي (FAB) من زر الإجراء الرئيسي لعرض إجراءات متعددة ذات صلة في Material 3.

يسمح ذلك بالوصول إلى الإجراءات الرئيسية مع الحفاظ على واجهة المستخدم نظيفة من خلال إخفاء الإجراءات الثانوية عندما لا تكون هناك حاجة إليها، واستبدال أزرار الاتصال السريع والأزرار العائمة الصغيرة المتراكمة.

استخدام قائمة زر الإجراء الرئيسي (FAB)

  • يتم فتحه من زر إجراء رئيسي لعرض ما بين إجراءَين وستة إجراءات ذات صلة تطفو على الشاشة.
  • يستخدم حجم قائمة واحدًا لزر الإجراء العائم في جميع أحجام هذا الزر.
  • لا يُستخدَم مع أزرار الإجراءات العائمة الموسّعة.
  • تتيح هذه الميزة استخدام مجموعات الألوان الأساسية والثانوية والثالثية.
ثلاث مجموعات ألوان لقائمة زر الإجراء العائم: أساسية وثانوية وثالثة.
الشكل 1. مجموعات ألوان قائمة زر الإجراء العائم: أساسية وثانوية وثلاثية

أمثلة

نموذج قائمة زر الإجراء العائم

يمكنك إقران FloatingActionButtonMenu مع ToggleFloatingActionButton لتوسيع قائمة إجراءات FloatingActionButtonMenuItem وتصغيرها. يخفي المقتطف التالي زر الإجراء الرئيسي للتبديل عند التمرير لأسفل القائمة ويوسع القائمة عند النقر عليها:

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