ExpandedDockedSearchBar
Common
@ExperimentalMaterial3Api
@Composable
fun ExpandedDockedSearchBar(
state: SearchBarState,
inputField: @Composable () -> Unit,
modifier: Modifier = Modifier,
shape: Shape = SearchBarDefaults.dockedShape,
colors: SearchBarColors = SearchBarDefaults.colors(),
tonalElevation: Dp = SearchBarDefaults.TonalElevation,
shadowElevation: Dp = SearchBarDefaults.ShadowElevation,
properties: PopupProperties = PopupProperties(focusable = true, clippingEnabled = false),
content: @Composable ColumnScope.() -> Unit,
) =
ExpandedDockedSearchBarImpl(
state = state,
properties = properties,
scrimColor = Color.Unspecified,
) { focusRequester ->
DockedSearchBarLayout(
state = state,
inputField = {
Box(
modifier = Modifier.focusRequester(focusRequester),
propagateMinConstraints = true,
) {
inputField()
}
},
modifier = modifier,
searchBarShape = shape,
dropdownShape = null,
dropdownGapSize = null,
colors = colors,
tonalElevation = tonalElevation,
shadowElevation = shadowElevation,
content = content,
)
}Parameters
| state | the state of the search bar. This state should also be passed to the inputField and the collapsed search bar. |
| inputField | the input field of this search bar that allows entering a query, typically a SearchBarDefaults.InputField. |
| modifier | the Modifier to be applied to this expanded search bar. |
| shape | the shape of the container wrapping both the inputField and content. |
| colors | SearchBarColors that will be used to resolve the colors used for this search bar in different states. See SearchBarDefaults.colors. |
| tonalElevation | when SearchBarColors.containerColor 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. |
| shadowElevation | the elevation for the shadow below this search bar. |
| properties | the platform-specific properties to configure the dialog's behavior. Any properties which limit the dialog's size (e.g. DialogProperties.usePlatformDefaultWidth) are ignored. |
| content | the content of this search bar to display search results below the inputField. |
