Interface

PullToRefreshState

The state of a PullToRefreshBox which tracks the distance that the container and indicator have been pulled.

Source set: Common

Added in 1.5.0-alpha17

interface PullToRefreshState

The state of a PullToRefreshBox which tracks the distance that the container and indicator have been pulled.

Each instance of PullToRefreshBox should have its own PullToRefreshState.

PullToRefreshState can be used with other progress indicators like so:

Properties

distanceFraction

Source set: Common

Added in 1.5.0-alpha17

@get:FloatRange(from = 0.0) val distanceFraction: Float

Distance percentage towards the refresh threshold. 0.0 indicates no distance, 1.0 indicates being at the threshold offset, > 1.0 indicates overshoot beyond the provided threshold.

isAnimating

Source set: Common

Added in 1.5.0-alpha17

val isAnimating: Boolean

whether the state is currently animating the indicator to the threshold offset, or back to the hidden offset

Functions

animateToThreshold

Added in 1.5.0-alpha17

suspend fun animateToThreshold()

Animate the distance towards the anchor or threshold position, where the indicator will be shown when refreshing.

animateToHidden

Added in 1.5.0-alpha17

suspend fun animateToHidden()

Animate the distance towards the position where the indicator will be hidden when idle

snapTo

Added in 1.5.0-alpha17

suspend fun snapTo(@FloatRange(from = 0.0) targetValue: Float)

Snap the indicator to the desired threshold fraction