Página inferior parcial

É possível mostrar parcialmente uma página inferior e permitir que o usuário a abra em tela cheia ou a dispense.

Para fazer isso, transmita ao ModalBottomSheet uma instância de SheetState com skipPartiallyExpanded definido como false.

Exemplo

Este exemplo demonstra como usar a propriedade sheetState de ModalBottomSheet para mostrar a página apenas parcialmente no início:

@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

Pontos principais sobre o código

Neste exemplo, observe o seguinte:

• showBottomSheet controla se o app mostra a página inferior.
• sheetState é uma instância de SheetState em que skipPartiallyExpanded é falso.
• ModalBottomSheet usa um modificador que garante que ele preencha a tela quando totalmente aberto.
• ModalBottomSheet usa sheetState como o valor do parâmetro sheetState.
  • Como resultado, a página é exibida apenas parcialmente quando aberta pela primeira vez. O usuário pode arrastar ou deslizar o anúncio para que ele ocupe a tela cheia ou seja dispensado.
• A lambda onDismissRequest controla o que acontece quando o usuário tenta dispensar a página inferior. Nesse caso, ele remove apenas a página.

Resultados

Quando o usuário pressiona o botão pela primeira vez, a página é exibida parcialmente:

Se o usuário deslizar para cima na página, ela vai preencher a tela:

Outros recursos

• Páginas inferiores