SearchBarScrollBehavior

A [SearchBarScrollBehavior] defines how a search bar should behave when the content beneath it is

SearchBarScrollBehavior

Interface

Common
@ExperimentalMaterial3Api
interface SearchBarScrollBehavior

A SearchBarScrollBehavior defines how a search bar should behave when the content beneath it is scrolled.

Properties

Common
@get:FrequentlyChangingValue var scrollOffset: Float

The search bar's current offset due to scrolling, in pixels. This offset is applied to the fixed size of the search bar to control the displayed size when content is being scrolled.

This value is typically negative.

Updates to the scrollOffset value are coerced between scrollOffsetLimit and 0.

Common
var scrollOffsetLimit: Float

The limit that a search bar can be offset due to scrolling, in pixels.

This value is typically negative.

Use this limit to coerce the scrollOffset value when it's updated.

Common
@get:FrequentlyChangingValue var contentOffset: Float

The total offset of the content scrolled under the search bar.

The content offset is used to compute the overlappedFraction, which can later be read by an implementation.

This value is updated by a SearchBarScrollBehavior whenever a nested scroll connection consumes scroll events. A common implementation would update the value to be the sum of all NestedScrollConnection.onPostScroll consumed.y values.

Common
val nestedScrollConnection: NestedScrollConnection

A NestedScrollConnection that should be attached to a Modifier.nestedScroll in order to keep track of scroll events.

Functions

fun Modifier.searchBarScrollBehavior(): Modifier

The modifier that adds scrolling behavior to the search bar component. AppBarWithSearch applies this automatically.