Struct MaterialSelect 

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

Implementations

impl<'a> MaterialSelect<'a>

pub fn new(selected: &'a mut Option<usize>) -> Self

Create a new select component.

Arguments

• selected - Mutable reference to the currently selected option value

Example

let mut selection = None;
let select = MaterialSelect::new(&mut selection);

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

Add an option to the select component.

Arguments

• value - Unique identifier for this option
• text - Display text for this option

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .option(1, "First Option")
    .option(2, "Second Option"));

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

Set placeholder text shown when no option is selected.

Arguments

• placeholder - The placeholder text to display

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .placeholder("Choose your option"));

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

Set label text that floats above the field when focused or has content.

Arguments

• label - The label text to display

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .label("Color"));

pub fn variant(self, variant: SelectVariant) -> Self

Set the visual variant of the select component.

Arguments

• variant - The variant (Filled or Outlined)

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .variant(SelectVariant::Outlined));

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

Enable or disable the select component.

Arguments

• enabled - Whether the select should be enabled (true) or disabled (false)

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .enabled(false)); // Disabled select

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

Set a fixed width for the select component.

Arguments

• width - The width in pixels

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .width(300.0)); // Fixed width of 300 pixels

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

Set error text to display below the select component.

Arguments

• text - The error message text

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .error_text("This field is required")); // Error message

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

Set helper text to display below the select component.

Arguments

• text - The helper message text

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .helper_text("Select an option from the list")); // Helper text

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

Set an icon to display at the start of the select field.

Arguments

• icon - The icon identifier (e.g., “home”, “settings”)

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .leading_icon("settings")); // Gear icon on the left

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

Set an icon to display at the end of the select field (overrides default dropdown arrow).

Arguments

• icon - The icon identifier (e.g., “check”, “close”)

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .trailing_icon("check")); // Check icon on the right

pub fn keep_open_on_select(self, keep_open: bool) -> Self

Set whether to keep the dropdown open after selecting an option.

Arguments

• keep_open - If true, the dropdown remains open after selection; if false, it closes (default behavior)

Example

let mut selection = None;
ui.add(MaterialSelect::new(&mut selection)
    .keep_open_on_select(true)); // Dropdown stays open after selection

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

Enable filtering of options by typing.

Arguments

• enable - If true, allows filtering options by text input

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

Enable search highlighting while typing.

Arguments

• enable - If true, highlights matching options while typing

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

Mark the field as required.

Arguments

• required - If true, marks the field as required

pub fn menu_width(self, width: f32) -> Self

Set independent menu width.

Arguments

• width - The width of the menu in pixels

pub fn menu_max_height(self, height: f32) -> Self

Set maximum menu height.

Arguments

• height - The maximum height of the menu in pixels

pub fn border_radius(self, radius: f32) -> Self

Set border radius for menu.

Arguments

• radius - The border radius in pixels

pub fn menu_alignment(self, alignment: MenuAlignment) -> Self

Set menu alignment.

Arguments

• alignment - The menu alignment (Start or End)

Trait Implementations

impl<'a> Widget for MaterialSelect<'a>

fn ui(self, ui: &mut Ui) -> Response

Allocate space, interact, paint, and return a Response.