Struct VirtualScrollState 

pub struct VirtualScrollState { /* private fields */ }

State for virtual scrolling of a list.

Implementations

impl VirtualScrollState

pub fn new(total_items: usize, item_height: ItemHeight) -> Self

Creates a new virtual scroll state.

pub fn with_config( total_items: usize, item_height: ItemHeight, config: VirtualScrollConfig, ) -> Self

Creates a new virtual scroll state with configuration.

pub fn set_container(&mut self, node: NodeId)

Sets the container node for the scroll content.

pub fn container(&self) -> Option<NodeId>

Gets the container node.

pub fn set_total_items(&mut self, count: usize)

Updates the total number of items.

pub fn total_items(&self) -> usize

Gets the total number of items.

pub fn set_viewport_height(&mut self, height: f32)

Updates the viewport height.

pub fn viewport_height(&self) -> f32

Gets the viewport height.

pub fn total_height(&self) -> f32

Calculates the total scroll height.

pub fn max_scroll_offset(&self) -> f32

Gets the maximum scroll offset.

pub fn scroll_offset(&self) -> f32

Gets the current scroll offset.

pub fn set_scroll_offset(&mut self, offset: f32)

Sets the scroll offset directly.

pub fn scroll_by(&mut self, delta: f32)

Scrolls by a delta amount.

pub fn scroll_to_item(&mut self, index: usize)

Scrolls to show a specific item.

pub fn scroll_to_item_centered(&mut self, index: usize)

Scrolls to center a specific item in the viewport.

pub fn get_item_offset(&self, index: usize) -> f32

Gets the Y offset for an item at the given index.

pub fn get_item_at_position(&self, y: f32) -> Option<usize>

Gets the item index at a given Y position.

pub fn update_animation(&mut self, dt: f32) -> bool

Updates smooth scrolling animation. Returns true if the scroll position changed.

pub fn calculate_visible_range(&self) -> Range<usize>

Calculates the visible range based on current scroll position.

pub fn update_visible(&mut self) -> (Vec<usize>, Vec<usize>)

Updates the visible range and returns items that need to be mounted/unmounted. Returns (items_to_mount, items_to_unmount).

pub fn mount_item(&mut self, index: usize, node_id: NodeId, height: f32)

Records a mounted item.

pub fn unmount_item(&mut self, index: usize) -> Option<NodeId>

Unmounts an item and returns its node ID.

pub fn get_mounted(&self, index: usize) -> Option<&MountedItem>

Gets the mounted item for an index.

pub fn mounted_items(&self) -> impl Iterator<Item = (usize, &MountedItem)>

Gets all mounted items.

pub fn visible_range(&self) -> Range<usize>

Gets the current visible range.

pub fn is_visible(&self, index: usize) -> bool

Checks if an index is in the visible range.

pub fn stats(&self) -> &VirtualScrollStats

Gets statistics about the virtual scroll.

pub fn update_stats(&mut self)

Updates statistics.

pub fn config(&self) -> &VirtualScrollConfig

Gets the configuration.

pub fn config_mut(&mut self) -> &mut VirtualScrollConfig

Gets mutable configuration.

Trait Implementations

impl Debug for VirtualScrollState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.