Struct ScrollState 

pub struct ScrollState { /* private fields */ }

State object for scroll position tracking.

Holds the current scroll offset and provides methods to programmatically control scrolling. Can be created with rememberScrollState().

This is a pure scroll model - it does NOT store ephemeral gesture/pointer state. Gesture state is managed locally in the scroll modifier.

Implementations

impl ScrollState

pub fn new(initial: f32) -> Self

Creates a new ScrollState with the given initial scroll position.

pub fn id(&self) -> u64

Get the unique ID of this ScrollState

pub fn value(&self) -> f32

Gets the current scroll position in pixels (reactive - triggers recomposition).

Use this in Composable functions when you want UI to update on scroll. Example: Text("Scroll position: ${scrollState.value()}")

pub fn value_non_reactive(&self) -> f32

Gets the current scroll position in pixels (non-reactive).

Use this in layout/measure phase to avoid triggering recomposition. This is called internally by ScrollNode::measure().

pub fn max_value(&self) -> f32

Gets the maximum scroll value.

pub fn dispatch_raw_delta(&self, delta: f32) -> f32

Scrolls by the given delta, clamping to valid range [0, max_value]. Returns the actual amount scrolled.

pub fn scroll_to(&self, position: f32)

Scrolls to the given position immediately.

Trait Implementations

impl Clone for ScrollState

fn clone(&self) -> ScrollState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.