ボトムシートの一部

ボトムシートを部分的に表示し、ユーザーが全画面表示にするか、閉じることができるようにします。

これを行うには、skipPartiallyExpanded を false に設定した SheetState のインスタンスを ModalBottomSheet に渡します。

例

次の例は、ModalBottomSheet の sheetState プロパティを使用して、最初にシートの一部のみを表示する方法を示しています。

@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 は、skipPartiallyExpanded が false である SheetState のインスタンスです。
  • ModalBottomSheet は、完全に展開されたときに画面全体に表示されるようにする修飾子を受け取ります。
  • ModalBottomSheet は、sheetState パラメータの値として sheetState を受け取ります。
    • そのため、最初に開いたときはシートの一部のみが表示されます。ユーザーは、ドラッグまたはスワイプして全画面表示にしたり、閉じたりできます。
  • onDismissRequest ラムダは、ユーザーがボトムシートを閉じようとしたときの動作を制御します。この場合、シートのみが削除されます。

結果

ユーザーが最初にボタンを押すと、シートが部分的に表示されます。

最初は画面の一部のみに表示されるボトムシート。ユーザーはスワイプして画面いっぱいに表示したり、閉じたりできます。
図 1. 部分的に表示されたボトムシート。

ユーザーがシートを上にスワイプすると、シートが画面いっぱいに表示されます。

ユーザーが画面いっぱいに展開したボトムシート。
図 2. 全画面表示のボトムシート。

参考情報