BottomSheetScaffold
Material Design standard bottom sheet scaffold.
Standard bottom sheets co-exist with the screen’s main UI region and allow for simultaneously viewing and interacting with both regions. They are commonly used to keep a feature or secondary content visible on screen when content in main UI region is frequently scrolled or panned.
This component provides API to put together several material components to construct your screen, by ensuring proper layout strategy for them and collecting necessary data so these components will work together correctly.
A simple example of a standard bottom sheet looks like this:
Parameters
the content of the bottom sheet
the Modifier to be applied to this scaffold
the state of the bottom sheet scaffold
the height of the bottom sheet when it is collapsed
Dp that defines what the maximum width the sheet will take. Pass in Dp.Unspecified for a sheet that spans the entire screen width.
the shape of the bottom sheet
the background color of the bottom sheet
the preferred content color provided by the bottom sheet to its children. Defaults to the matching content color for sheetContainerColor, or if that is not a color from the theme, this will keep the same content color set above the bottom sheet.
when sheetContainerColor is ColorScheme.surface, a translucent primary color overlay is applied on top of the container. A higher tonal elevation value will result in a darker color in light theme and lighter color in dark theme. See also: Surface.
the shadow elevation of the bottom sheet
optional visual marker to pull the scaffold's bottom sheet
whether the sheet swiping is enabled and should react to the user's input
top app bar of the screen, typically a SmallTopAppBar
component to host Snackbars that are pushed to be shown via SnackbarHostState.showSnackbar, typically a SnackbarHost
the color used for the background of this scaffold. Use Color.Transparent to have no color.
the preferred color for content inside this scaffold. Defaults to either the matching content color for containerColor, or to the current LocalContentColor if containerColor is not a color from the theme.
content of the screen. The lambda receives a PaddingValues that should be applied to the content root via Modifier.padding and Modifier.consumeWindowInsets to properly offset top and bottom bars. If using Modifier.verticalScroll, apply this modifier to the child of the scroll, and not on the scroll itself.