Частично развернутый нижний экран

Вы можете частично показать нижний экран, а затем позволить пользователю развернуть его в полноэкранный режим или закрыть.

Для этого передайте в ModalBottomSheet экземпляр SheetState, в котором для skipPartiallyExpanded задано значение false.

Пример

В этом примере показано, как использовать свойство sheetState объекта ModalBottomSheet, чтобы сначала показывать лист только частично:

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

Важные сведения о коде

Обратите внимание на следующее:

  • showBottomSheet определяет, будет ли приложение показывать нижний экран.
  • sheetState – это экземпляр SheetState, где skipPartiallyExpanded имеет значение false.
  • ModalBottomSheet принимает модификатор, который обеспечивает заполнение экрана при полном развертывании.
  • ModalBottomSheet принимает sheetState в качестве значения параметра sheetState.
    • В результате при первом открытии лист отображается только частично. Пользователь может перетащить или смахнуть его, чтобы развернуть на весь экран или закрыть.
  • Лямбда-выражение onDismissRequest определяет, что происходит, когда пользователь пытается закрыть нижний экран. В этом случае удаляется только таблица.

Результаты

Когда пользователь впервые нажимает кнопку, лист отображается частично:

Нижний экран, который изначально занимает только часть экрана. Пользователь может развернуть его на весь экран или закрыть.
Рисунок 1. Частично показанный нижний экран.

Если пользователь проведет по экрану вверх, окно развернется на весь экран:

Нижний экран, который пользователь развернул на весь экран.
Рисунок 2. Полноэкранный нижний экран.

Дополнительные ресурсы