Struct SelectWidget 

pub struct SelectWidget {
    pub open: bool,
    /* private fields */
}

A scrollable pick-list widget with type-ahead filtering.

focused indexes the filtered set returned by Self::matches, not options directly. When the filter matches nothing, value()/display() return "" and next()/prev() are no-ops.

Fields

open: bool

Implementations

impl SelectWidget

pub fn new() -> Self

pub fn set_options(&mut self, options: Vec<SelectOption>)

Replace the option list, reset focus to 0, and clear any query.

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

Indices into options whose label contains query case-insensitively. An empty query returns all indices.

pub fn value(&self) -> &str

The id of the focused filtered option, or "" when no match exists.

pub fn display(&self) -> &str

The display label of the focused filtered option, or "" when no match.

pub fn option_count(&self) -> usize

Number of options currently held (unfiltered).

pub fn options(&self) -> &[SelectOption]

The raw option list, for rendering.

pub fn query(&self) -> &str

The active type-ahead query string.

pub fn focused_in_filtered(&self) -> usize

Index of the focused entry within the filtered set (i.e. matches()).

pub fn next(&mut self)

Advance focus by one step within the filtered set, wrapping around.

pub fn prev(&mut self)

Retreat focus by one step within the filtered set, wrapping around.

pub fn filter_push(&mut self, c: char)

Append a character to the type-ahead query and reset focus to 0.

pub fn filter_pop(&mut self)

Remove the last character from the type-ahead query and reset focus to 0.

pub fn confirm(&mut self)

Resolve the current filtered selection to the raw options index, clear the query, and close the dropdown. Call this on SelectConfirm so the selection survives query removal.

pub fn set_options_preserving_id(&mut self, options: Vec<SelectOption>)

Replace the option list, keeping the previously selected id focused if it exists in the new list; falls back to index 0 otherwise. Clears query.

Trait Implementations

impl Clone for SelectWidget

fn clone(&self) -> SelectWidget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SelectWidget

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

Formats the value using the given formatter.

impl Default for SelectWidget

fn default() -> Self

Returns the “default value” for a type.