Struct MaterialSelect 

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

Material Design select/dropdown component.

Select components allow users to choose one option from a list. They display the currently selected option in a text field-style input and show all options in a dropdown menu when activated.

Example

let mut selected = Some(1);
 
ui.add(MaterialSelect::new(&mut selected)
    .placeholder("Choose an option")
    .option(0, "Option 1")
    .option(1, "Option 2")
    .option(2, "Option 3")
    .helper_text("Select your preferred option"));

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 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

Trait Implementations

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

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

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