Struct Select 

pub struct Select { /* private fields */ }

A select/dropdown widget with optional fuzzy search

Keyboard Shortcuts

Key	Action
Enter	Open dropdown (when closed) / Confirm selection (when open)
Space	Toggle dropdown open/close (non-searchable mode only)
Up / k	Move to previous option (when open, non-searchable mode)
Down / j	Move to next option (when open, non-searchable mode)
Up	Move to previous option (when open, searchable mode)
Down	Move to next option (when open, searchable mode)
Home	Jump to first option (when open)
End	Jump to last option (when open)
Escape	Close dropdown and clear search query (when open)
Backspace	Delete last character from search query (when open, searchable mode)
Char	Append character to search query (when open, searchable mode)

Implementations

impl Select

pub fn new() -> Self

Create a new select widget

pub fn options(self, options: Vec<impl Into<String>>) -> Self

Set options

pub fn option(self, option: impl Into<String>) -> Self

Add a single option

pub fn searchable(self, enable: bool) -> Self

Enable fuzzy search when dropdown is open

pub fn highlight_fg(self, color: Color) -> Self

Set highlight color for matched characters

pub fn selected(self, index: usize) -> Self

Set selected index, clamped to the valid range

pub fn placeholder(self, text: impl Into<String>) -> Self

Set placeholder text

pub fn fg(self, color: Color) -> Self

Set foreground color

pub fn bg(self, color: Color) -> Self

Set background color

pub fn selected_style(self, fg: Color, bg: Color) -> Self

Set selected item colors

pub fn width(self, width: u16) -> Self

Set fixed width

pub fn focused(self, focused: bool) -> Self

Set focused state

pub fn disabled(self, disabled: bool) -> Self

Set disabled state

pub fn selected_index(&self) -> usize

Get selected index

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

Get selected value

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

Get selected value (alias for value)

pub fn is_open(&self) -> bool

Check if dropdown is open

pub fn toggle(&mut self)

Toggle dropdown open/close

pub fn open(&mut self)

Open the dropdown

pub fn close(&mut self)

Close the dropdown

pub fn select_next(&mut self)

Select next option

pub fn select_prev(&mut self)

Select previous option

pub fn select_first(&mut self)

Select first option

pub fn select_last(&mut self)

Select last option

pub fn query(&self) -> &str

Get current search query

pub fn set_query(&mut self, query: impl Into<String>)

Set search query and update filter

pub fn clear_query(&mut self)

Clear search query

pub fn is_searchable(&self) -> bool

Check if searchable mode is enabled

pub fn filtered_options(&self) -> &[usize]

Get filtered options (indices into original options)

pub fn visible_count(&self) -> usize

Get number of visible (filtered) options

pub fn get_match(&self, option: &str) -> Option<FuzzyMatch>

Get fuzzy match for an option

pub fn handle_key(&mut self, key: &Key) -> bool

Handle key input, returns true if selection changed

pub fn len(&self) -> usize

Get number of options

pub fn is_empty(&self) -> bool

Check if select has no options

impl Select

pub fn element_id(self, id: impl Into<String>) -> Self

Set element ID for CSS selector (#id)

pub fn class(self, class: impl Into<String>) -> Self

Add a CSS class

pub fn classes<I, S>(self, classes: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Add multiple CSS classes

Trait Implementations

impl Clone for Select

fn clone(&self) -> Select

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Select

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

Formats the value using the given formatter.

impl Default for Select

fn default() -> Self

Returns the “default value” for a type.

impl Interactive for Select

fn handle_key(&mut self, event: &KeyEvent) -> EventResult

Handle keyboard event

fn handle_mouse(&mut self, event: &MouseEvent, area: Rect) -> EventResult

Handle mouse event

fn focusable(&self) -> bool

Check if the widget can receive focus

fn on_focus(&mut self)

Called when the widget receives focus

fn on_blur(&mut self)

Called when the widget loses focus

impl StyledView for Select

fn set_id(&mut self, id: impl Into<String>)

Set element ID

fn add_class(&mut self, class: impl Into<String>)

Add a CSS class

fn remove_class(&mut self, class: &str)

Remove a CSS class

fn toggle_class(&mut self, class: &str)

Toggle a CSS class

fn has_class(&self, class: &str) -> bool

Check if has class

impl View for Select

fn render(&self, ctx: &mut RenderContext<'_>)

Render the view to the given context

fn id(&self) -> Option<&str>

Get element ID (for CSS #id selectors)

fn classes(&self) -> &[String]

Get CSS classes (for CSS .class selectors)

fn meta(&self) -> WidgetMeta

Get widget metadata for DOM

fn widget_type(&self) -> &'static str

Get widget type name (for CSS type selectors)

fn children(&self) -> &[Box<dyn View>]

Get child views (for container widgets)