SearchBarScrollBehavior
-
Cmn
@ExperimentalMaterial3Api
interface SearchBarScrollBehavior
A SearchBarScrollBehavior defines how a search bar should behave when the content beneath it is scrolled.
| See also | |
|---|---|
enterAlwaysSearchBarScrollBehavior |
Summary
Public functions |
||
|---|---|---|
Modifier |
The modifier that adds scrolling behavior to the search bar component. |
Cmn
|
Public properties |
||
|---|---|---|
Float |
The total offset of the content scrolled under the search bar. |
Cmn
|
NestedScrollConnection |
A |
Cmn
|
Float |
The search bar's current offset due to scrolling, in pixels. |
Cmn
|
Float |
The limit that a search bar can be offset due to scrolling, in pixels. |
Cmn
|
Public functions
searchBarScrollBehavior
fun Modifier.searchBarScrollBehavior(): Modifier
The modifier that adds scrolling behavior to the search bar component. AppBarWithSearch applies this automatically.
Public properties
contentOffset
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.
nestedScrollConnection
val nestedScrollConnection: NestedScrollConnection
A NestedScrollConnection that should be attached to a Modifier.nestedScroll in order to keep track of scroll events.
scrollOffset
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.
scrollOffsetLimit
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.