เมนูปุ่มการทำงานแบบลอย (FAB)

เมนูปุ่มการทำงานแบบลอย (FAB) จะเปิดขึ้นจาก FAB เพื่อแสดงการดำเนินการที่เกี่ยวข้องหลายรายการใน Material 3

ซึ่งจะช่วยให้เข้าถึงการดำเนินการหลักได้ ขณะเดียวกันก็ทำให้ UI ดูสะอาดตาด้วยการซ่อนการดำเนินการรองเมื่อไม่จำเป็น โดยแทนที่ปุ่มโทรด่วนและ FAB ขนาดเล็กที่ซ้อนกัน

การใช้เมนู FAB

  • เปิดจาก FAB เพื่อแสดงการดำเนินการที่เกี่ยวข้อง 2-6 รายการที่ลอยอยู่บนหน้าจอ
  • ใช้ขนาดเมนู FAB เดียวกับขนาด FAB ทั้งหมด
  • ไม่ได้ใช้กับ FAB แบบขยาย
  • รองรับชุดสีหลัก สีรอง และสีตติยภูมิ
ชุดสีของเมนู FAB 3 ชุด ได้แก่ สีหลัก สีรอง และสีตติยภูมิ
รูปที่ 1 ชุดสีของเมนู 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) },
                )
            }
        }
    }
}