Częściowa plansza dolna

Możesz częściowo wyświetlić dolną planszę, a następnie zezwolić użytkownikowi na jej cały ekran lub zamknięcie.

Aby to zrobić, przekaż ModalBottomSheet instancję SheetState z wartością skipPartiallyExpanded ustawioną na false.

Przykład

Ten przykład pokazuje, jak można użyć właściwości sheetState właściwości ModalBottomSheet, by początkowo wyświetlić arkusz tylko częściowo:

@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)
                )
            }
        }
    }
}
BottomSheet.kt

Najważniejsze informacje o kodzie

W tym przykładzie pamiętaj o tych kwestiach:

  • showBottomSheet określa, czy aplikacja ma wyświetlać planszę dolną.
  • sheetState to instancja SheetState, w której skipPartiallyExpanded to fałsz.
  • ModalBottomSheet przyjmuje modyfikator, który po pełnym rozwinięciu wypełnia ekran.
  • ModalBottomSheet przyjmuje wartość sheetState jako wartość parametru sheetState.
    • W związku z tym po pierwszym otwarciu arkusz wyświetla się tylko częściowo. Użytkownik może ją przeciągnąć, aby włączyć pełny ekran, lub ją zamknąć.
  • Funkcja lambda onDismissRequest określa, co się dzieje, gdy użytkownik próbuje zamknąć planszę dolną. W takim przypadku spowoduje to tylko usunięcie arkusza.

Wyniki

Gdy użytkownik po raz pierwszy kliknie przycisk, arkusz wyświetli się częściowo:

Plansza dolna, która początkowo wypełnia tylko część ekranu. Użytkownik może przesunąć palcem, aby wypełnić ekran, lub go zamknąć.
Rysunek 1. Częściowo wyświetlona plansza dolna.

Jeśli użytkownik przesunie palcem w górę po arkuszu, wypełni on ekran:

Plansza dolna, która użytkownik rozwinęła, aby zapełniła ekran.
Rysunek 2. Plansza dolna na pełnym ekranie.

Dodatkowe materiały