Struct ListState 

pub struct ListState { /* private fields */ }

Unified list state machine for single and multi-select

Owns the item texts so filtering stays internal to the state machine. visible maps display positions to absolute indices into items, and cursor addresses a position within visible. The selected set holds absolute indices, which is what lets selections survive filtering.

Implementations

impl ListState

pub fn new(items: Vec<String>, multi_select: bool, initial_diff: bool) -> Self

pub fn items(&self) -> &[String]

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn cursor(&self) -> usize

Cursor position within the visible (possibly filtered) list

pub fn search_active(&self) -> bool

pub fn search_query(&self) -> Option<&str>

The current search query, Some (possibly empty) while search mode is active

pub fn visible_items(&self) -> impl Iterator<Item = (usize, &str)>

The currently visible items as (absolute index, text) pairs

pub fn highlighted(&self) -> Option<usize>

Absolute index of the item under the cursor, None when the filtered list is empty

pub fn show_diff(&self) -> bool

pub fn set_show_diff(&mut self, show_diff: bool)

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

pub fn selected_count(&self) -> usize

pub fn selected_indices(&self) -> Vec<usize>

Get sorted list of selected indices for deterministic iteration

pub fn multi_select(&self) -> bool

pub fn handle(&mut self, action: ListAction) -> Option<ListResult>

Handle a list action, returns Some if the interaction is complete

Trait Implementations

impl Clone for ListState

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ListState

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

Formats the value using the given formatter.