Virtual list
A list that builds only the visible rows.
render returns any IntoNode, such as text(..) or a widget builder.
GUITUIRuns in the browser
virtual_listPreview
























Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Header above the list Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Footer below the list
Header above the list Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Footer below the list
Usage example
fn virtual_list_demo(selected: bool) -> impl IntoNode + 'static { let items: Vec<String> = (1..=20).map(|i| format!("Item {i}")).collect(); virtual_list(items, move |index, item| { list_row(selected && index == 1, item.clone(), format!("{index}")) }) .selection(SelectionMode::Single) .viewport_height(140.0)}fn virtual_list_demo( selected: bool,) -> impl IntoNode + 'static { let items: Vec<String> = (1..=20) .map(|i| format!("Item {i}")) .collect(); virtual_list( items, move |index, item| { list_row( selected && index == 1, item.clone(), format!("{index}"), ) }, ) .selection(SelectionMode::Single) .viewport_height(140.0)}fn virtual_list_fill_demo() -> NodeBuilder { let items: Vec<String> = (1..=20).map(|i| format!("Item {i}")).collect(); container() .layout(LayoutStyle::flex_column().fill_width().height(152.0)) .child(text("Header above the list").nowrap()) .child( container() .layout(LayoutStyle::flex_column().fill_width().grow(1.0)) .child( virtual_list(items, |index, item| { list_row(false, item.clone(), format!("{index}")) }) .viewport_fill(), ), ) .child(text("Footer below the list").nowrap()) }fn virtual_list_fill_demo()-> NodeBuilder { let items: Vec<String> = (1..=20) .map(|i| format!("Item {i}")) .collect(); container() .layout( LayoutStyle::flex_column() .fill_width() .height(152.0), ) .child( text("Header above the list") .nowrap(), ) .child( container() .layout( LayoutStyle::flex_column() .fill_width() .grow(1.0), ) .child( virtual_list( items, |index, item| { list_row( false, item.clone(), format!("{index}"), ) }, ) .viewport_fill(), ), ) .child( text("Footer below the list") .nowrap(), )}States
All 6 captured states, each drawn by the window host and by the terminal host.
Default

DefaultItem 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17

HoverItem 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17

PressedItem 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17

FocusedItem 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17

SelectedItem 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Item 18 17
Fill

DefaultHeader above the list Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Footer below the list
Header above the list Item 1 0 Item 2 1 Item 3 2 Item 4 3 Item 5 4 Item 6 5 Item 7 6 Item 8 7 Item 9 8 Item 10 9 Item 11 10 Item 12 11 Item 13 12 Item 14 13 Item 15 14 Item 16 15 Item 17 16 Footer below the list
API
| Name | Signature | Purpose |
|---|---|---|
virtual_list | fn virtual_list<T, R: Fn(usize, &T) -> N, N: IntoNode, I: IntoList<T, R>>(items: I, render: R) -> VirtualListBuilder<T, R> | A list that builds only the visible rows. render returns any IntoNode, such as text(..) or a widget builder. |