Một phần bảng dưới cùng

Bạn có thể hiện một phần bảng dưới cùng rồi cho phép người dùng toàn màn hình hoặc đóng quảng cáo.

Để thực hiện việc này, hãy truyền ModalBottomSheet một thực thể của SheetState với skipPartiallyExpanded được đặt thành false.

Ví dụ

Ví dụ này minh hoạ cách bạn có thể sử dụng thuộc tính sheetState của ModalBottomSheet để hiển thị một phần của trang tính ở bước đầu tiên:

@Composable
fun PartialBottomSheet() {
    var showBottomSheet by remember { mutableStateOf(false) }
    val sheetState = rememberModalBottomSheetState(
        skipPartiallyExpanded = false,
    )

    Column(
        modifier = Modifier.fillMaxWidth(),
        horizontalAlignment = Alignment.CenterHorizontally,
    ) {
        Button(
            onClick = { showBottomSheet = true }
        ) {
            Text("Display partial bottom sheet")
        }

        if (showBottomSheet) {
            ModalBottomSheet(
                modifier = Modifier.fillMaxHeight(),
                sheetState = sheetState,
                onDismissRequest = { showBottomSheet = false }
            ) {
                Text(
                    "Swipe up to open sheet. Swipe down to dismiss.",
                    modifier = Modifier.padding(16.dp)
                )
            }
        }
    }
}

Các điểm chính về mã

Trong ví dụ này, hãy lưu ý những điều sau:

  • showBottomSheet kiểm soát việc ứng dụng có hiển thị bảng dưới cùng hay không.
  • sheetState là một thực thể của SheetState trong đó skipPartiallyExpanded là giá trị false.
  • ModalBottomSheet sử dụng một đối tượng sửa đổi đảm bảo lấp đầy màn hình khi được mở rộng hoàn toàn.
  • ModalBottomSheet lấy sheetState làm giá trị cho sheetState của nó .
    • Do đó, trang tính chỉ hiển thị một phần khi được mở lần đầu. Chiến lược phát hành đĩa đơn sau đó, người dùng có thể kéo hoặc vuốt quảng cáo để chuyển sang chế độ toàn màn hình hoặc bỏ qua.
  • Hàm lambda onDismissRequest kiểm soát những gì sẽ xảy ra khi người dùng cố gắng đóng bảng dưới cùng. Trong trường hợp này, thao tác này chỉ xoá trang tính.

Kết quả

Khi người dùng nhấn nút này lần đầu, trang tính sẽ hiển thị một phần:

Bảng dưới cùng ban đầu chỉ lấp đầy một phần màn hình. Người dùng có thể vuốt để lấp đầy màn hình hoặc đóng màn hình
Hình 1. Bảng dưới cùng chỉ hiển thị một phần.

Nếu người dùng vuốt lên trên trang tính, thao tác này sẽ lấp đầy màn hình:

Bảng dưới cùng mà người dùng đã mở rộng để lấp đầy màn hình.
Hình 2. Bảng dưới cùng ở chế độ toàn màn hình.

Tài nguyên khác