Struct VirtualList 

pub struct VirtualList<'a> { /* private fields */ }

A virtualized list. See the module docs.

Implementations

impl<'a> VirtualList<'a>

pub fn new(id: &'a str, rows: usize, heights: RowHeights<'a>) -> Self

pub fn fling(self, on: bool) -> Self

Drag the list to scroll it (off by default): let go while moving and it keeps going, then eases to rest; pulled past either end it stretches with rubber-band resistance and springs back. Reduced motion keeps the drag but drops the fling.

pub fn label(self, text: &'a str) -> Self

The name a screen reader announces for the list (a human name, not the automation id).

pub fn changed_rows(self, rows: &'a [usize]) -> Self

Rows whose height changed since the last frame, with RowHeights::Variable: only these are measured again (O(log rows) each) while the revision and row count stay the same.

pub fn selected(self, row: Option<usize>) -> Self

The selected (cursor) row: highlighted and moved by the keyboard.

pub fn is_selected(self, f: &'a dyn Fn(usize) -> bool) -> Self

Highlight several rows (multi-selection); called for visible rows only.

pub fn overscan(self, rows: usize) -> Self

Extra rows laid out above and below the viewport.

pub fn stripes(self, yes: bool) -> Self

pub fn scroll_to(self, row: Option<usize>) -> Self

Scroll so this row is visible.

pub fn max_height(self, h: f32) -> Self

pub fn row_label(self, f: &'a dyn Fn(usize) -> &'a str) -> Self

Accessible/automation label of a row (visible rows only): the screen reader’s name for it.

pub fn type_ahead(self, text: &'a dyn Fn(usize) -> &'a str) -> Self

Type-ahead: letters typed while the list has the focus, within TYPE_AHEAD_SECS of each other, move the cursor to the next row whose text starts with them (ignoring case). text(row) is called only on a keystroke, from the cursor on.

pub fn selection(self, selection: &'a mut Selection) -> Self

Multi-selection owned by the app: click, Shift-click and Shift+arrows, ⌘/Ctrl-click and ⌘A update it in place. Its cursor replaces selected; rows from is_selected still show as selected.

pub fn show(self, ui: &mut Ui, row: impl FnMut(&mut Ui, Row)) -> ListResponse