Hoja inferior parcial

Puedes mostrar parcialmente una hoja inferior y, luego, permitir que el usuario la cree pantalla completa o descartarla.

Para ello, pasa a tu ModalBottomSheet una instancia de SheetState con skipPartiallyExpanded establecido en false.

Ejemplo

En este ejemplo, se muestra cómo puedes usar la propiedad sheetState de ModalBottomSheet para mostrar la hoja solo parcialmente al principio:

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

Puntos clave sobre el código

En este ejemplo, ten en cuenta lo siguiente:

  • showBottomSheet controla si la app muestra la hoja inferior.
  • sheetState es una instancia de SheetState en la que skipPartiallyExpanded es falso.
  • ModalBottomSheet toma un modificador que garantiza que ocupe toda la pantalla cuando se expanden por completo.
  • ModalBottomSheet toma sheetState como el valor de su sheetState. parámetro.
    • Como resultado, la hoja solo se muestra parcialmente cuando se abre por primera vez. El el usuario puede arrastrarlo o deslizarlo para verlo en pantalla completa o descartarlo.
  • La lambda onDismissRequest controla lo que sucede cuando el usuario intenta hacer lo siguiente: descartar la hoja inferior. En este caso, solo quita la hoja.

Resultados

Cuando el usuario presiona el botón por primera vez, la hoja se muestra parcialmente:

Es una hoja inferior que inicialmente solo ocupa parte de la pantalla. El usuario puede deslizar el dedo para llenar la pantalla con el elemento o descartarlo.
Figura 1: Se muestra parcialmente la hoja inferior.

Si el usuario desliza el dedo hacia arriba en la hoja, se completará la pantalla:

Una hoja inferior que el usuario expandió para llenar la pantalla.
Figura 2: Hoja inferior de pantalla completa.

Recursos adicionales