Compose Multiplatform Material3/androidx.compose.material3/SwipeToDismissBoxState

SwipeToDismissBoxState

State of the SwipeToDismissBox composable.

Constructors

constructor(initialValue: SwipeToDismissBoxValue, positionalThreshold: (totalDistance: Float) -> Float)

State of the SwipeToDismissBox composable.

constructor(initialValue: SwipeToDismissBoxValue, density: Density, confirmValueChange: (SwipeToDismissBoxValue) -> Boolean = { true }, positionalThreshold: (totalDistance: Float) -> Float)

State of the SwipeToDismissBox composable.

Types

Companion

object Companion

Properties

currentValue

val currentValue: SwipeToDismissBoxValue

The current state value of the SwipeToDismissBoxState.

dismissDirection

val dismissDirection: SwipeToDismissBoxValue

The direction (if any) in which the composable has been or is being dismissed.

progress

@get:FloatRange(from = 0.0, to = 1.0)

val progress: Float

The fraction of the progress going from currentValue to targetValue, within 0f..1f bounds.

settledValue

val settledValue: SwipeToDismissBoxValue

The value the SwipeToDismissBoxState is currently settled at. When progressing through multiple anchors, e.g. A -> B -> C, settledValue will stay the same until settled at an anchor, while currentValue will update to the closest anchor.

targetValue

val targetValue: SwipeToDismissBoxValue

The target state. This is the closest state to the current offset (taking into account positional thresholds). If no interactions like animations or drags are in progress, this will be the current state.

Functions

dismiss

suspend fun dismiss(direction: SwipeToDismissBoxValue)

Dismiss the component in the given direction, with an animation and suspend. This method will throw CancellationException if the animation is interrupted

requireOffset

fun requireOffset(): Float

Require the current offset.

reset

suspend fun reset()

Reset the component to the default position with animation and suspend until it if fully reset or animation has been cancelled. This method will throw CancellationException if the animation is interrupted

snapTo

suspend fun snapTo(targetValue: SwipeToDismissBoxValue)

Set the state without any animation and suspend until it's set