Enum ScrollRequest 

pub enum ScrollRequest {
    ToRow {
        list_key: String,
        row: usize,
        align: ScrollAlignment,
    },
    ToRowKey {
        list_key: String,
        row_key: String,
        align: ScrollAlignment,
    },
    EnsureVisible {
        container_key: String,
        y: f32,
        h: f32,
    },
}

What the app produces from crate::App::drain_scroll_requests. Three shapes today:

• ScrollRequest::ToRow — “scroll the virtual list keyed list_key so row row lands per align.” Resolved during layout of the matching virtual_list / virtual_list_dyn using the live viewport and the row-height cache.
• ScrollRequest::ToRowKey — same operation, but targets the virtual-list row by stable row identity instead of current row index. Prefer this for virtual_list_dyn when the app already has message/thread/commit ids.
• ScrollRequest::EnsureVisible — “scroll the nearest scroll container under the node keyed container_key so the content- space rect y..y+h is visible.” Resolved during layout of the matching scroll(...) container; minimal-displacement (top edge if above viewport, bottom edge if below, no-op if already visible). Used by crate::widgets::text_area for caret-into-view on keyboard navigation, and available for any widget that needs to keep an inner anchor on screen.

Variants

ToRow

Bring row of the virtual list keyed list_key into view per align.

Fields

list_key: String

row: usize

align: ScrollAlignment

ToRowKey

Bring the row identified by row_key in the virtual list keyed list_key into view per align.

Fields

list_key: String

row_key: String

align: ScrollAlignment

EnsureVisible

Ensure the content-space rect at y..y+h is visible inside the scroll container under the node keyed container_key. container_key is the outer widget’s key (e.g. the text_area’s key) — the resolver descends to find the nearest Kind::Scroll inside that node.

Fields

container_key: String

y: f32

h: f32

Implementations

impl ScrollRequest

pub fn new( list_key: impl Into<String>, row: usize, align: ScrollAlignment, ) -> Self

Construct a ScrollRequest::ToRow. Kept for source-compat with callers that predate the enum — ScrollRequest::new(...) has always meant “scroll a virtual list to a row.”

pub fn to_row_key( list_key: impl Into<String>, row_key: impl Into<String>, align: ScrollAlignment, ) -> Self

Construct a ScrollRequest::ToRowKey. Dynamic virtual lists resolve this against the same stable row identities passed to crate::virtual_list_dyn.

pub fn ensure_visible(container_key: impl Into<String>, y: f32, h: f32) -> Self

Construct a ScrollRequest::EnsureVisible for the widget keyed container_key, asking the resolver to keep y..y+h (in the scroll container’s content coordinates) inside the viewport.

Trait Implementations

impl Clone for ScrollRequest

fn clone(&self) -> ScrollRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScrollRequest

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

Formats the value using the given formatter.