Struct Select 

pub struct Select<'a, T, L, V, Message, Renderer>
where
    T: ToString + PartialEq + Clone,
    L: Borrow<[T]> + 'a,
    V: Borrow<T> + 'a,
    Renderer: Renderer,
{ /* private fields */ }

A Material select field.

Implementations

impl<'a, T, L, V, Message, Renderer> Select<'a, T, L, V, Message, Renderer>

where T: ToString + PartialEq + Clone, L: Borrow<[T]> + 'a, V: Borrow<T> + 'a, Message: Clone, Renderer: Renderer,

pub fn new( options: L, selected: Option<V>, on_select: impl Fn(T) -> Message + 'a, ) -> Self

Creates a new Select with the given list of options, selected value, and message to produce when an option is selected.

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

Sets the placeholder of the select.

Examples found in repository

examples/showcase/pages/inputs.rs (line 20)

pub(super) fn view(state: &Showcase) -> material::Element<'_, Message> {
    let input = material::widget::text_input::outlined("Write a note", &state.note)
        .on_input(Message::TextChanged);

    let editor = material::widget::text_editor::outlined_area(&state.editor_content)
        .placeholder("Write details")
        .on_action(Message::EditorAction);

    let select_options = ["Assist", "Suggestion", "Filter"];
    let select = material::widget::select::outlined(
        select_options,
        state.select_choice,
        Message::SelectChanged,
    )
    .placeholder("Choose a chip")
    .label("Chip type");

    let combobox = material::widget::combobox::outlined_with_input(
        &state.combobox_options,
        "Search a chip",
        &state.combobox_input,
        state.combobox_choice.as_ref(),
        Message::ComboboxSelected,
    )
    .label("Searchable chip")
    .on_input(Message::ComboboxInputChanged);

    page::sections([
        page::section("Text fields", page::stack([input.into(), editor.into()])).into(),
        page::section(
            "Selection fields",
            page::stack([select.into(), combobox.into()]),
        )
        .into(),
        page::section("Pickers", pickers(state)).into(),
        page::section("Search", search_bar(state)).into(),
        page::section("Dividers", dividers()).into(),
    ])
    .into()
}

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

Sets the floating label of the select.

Examples found in repository

examples/showcase/pages/inputs.rs (line 21)

pub(super) fn view(state: &Showcase) -> material::Element<'_, Message> {
    let input = material::widget::text_input::outlined("Write a note", &state.note)
        .on_input(Message::TextChanged);

    let editor = material::widget::text_editor::outlined_area(&state.editor_content)
        .placeholder("Write details")
        .on_action(Message::EditorAction);

    let select_options = ["Assist", "Suggestion", "Filter"];
    let select = material::widget::select::outlined(
        select_options,
        state.select_choice,
        Message::SelectChanged,
    )
    .placeholder("Choose a chip")
    .label("Chip type");

    let combobox = material::widget::combobox::outlined_with_input(
        &state.combobox_options,
        "Search a chip",
        &state.combobox_input,
        state.combobox_choice.as_ref(),
        Message::ComboboxSelected,
    )
    .label("Searchable chip")
    .on_input(Message::ComboboxInputChanged);

    page::sections([
        page::section("Text fields", page::stack([input.into(), editor.into()])).into(),
        page::section(
            "Selection fields",
            page::stack([select.into(), combobox.into()]),
        )
        .into(),
        page::section("Pickers", pickers(state)).into(),
        page::section("Search", search_bar(state)).into(),
        page::section("Dividers", dividers()).into(),
    ])
    .into()
}

pub fn width(self, width: impl Into<Length>) -> Self

Sets the width of the select.

pub fn menu_height(self, menu_height: impl Into<Length>) -> Self

Sets the height of the menu.

pub fn padding(self, padding: impl Into<Padding>) -> Self

Sets the padding of the select field.

pub fn option_padding(self, padding: impl Into<Padding>) -> Self

Sets the padding of each menu option.

pub fn text_size(self, size: impl Into<Pixels>) -> Self

Sets the text size of the select and its menu items.

pub fn text_line_height(self, line_height: impl Into<LineHeight>) -> Self

Sets the text line height of the select and its menu items.

pub fn text_shaping(self, shaping: Shaping) -> Self

Sets the text shaping strategy.

pub fn font(self, font: impl Into<Renderer::Font>) -> Self

Sets the font.

pub fn handle(self, handle: Handle<Renderer::Font>) -> Self

Sets the trailing handle.

pub fn on_open(self, on_open: Message) -> Self

Sets the message produced when the menu is opened.

pub fn on_close(self, on_close: Message) -> Self

Sets the message produced when the menu is closed.

pub fn style(self, style: impl Fn(&Theme, Status) -> Style + 'a) -> Self

where <Theme as Catalog>::Class<'a>: From<StyleFn<'a, Theme>>,

Sets the style of the select.

pub fn menu_style(self, style: impl Fn(&Theme) -> Style + 'a) -> Self

where <Theme as Catalog>::Class<'a>: From<StyleFn<'a, Theme>>,

Sets the style of the menu.

Trait Implementations

impl<T, L, V, Message, Renderer> Debug for Select<'_, T, L, V, Message, Renderer>

where T: ToString + PartialEq + Clone, L: Borrow<[T]>, V: Borrow<T>, Renderer: Renderer,

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

Formats the value using the given formatter.

impl<'a, T, L, V, Message, Renderer> From<Select<'a, T, L, V, Message, Renderer>> for Element<'a, Message, Theme, Renderer>

where T: Clone + ToString + PartialEq + 'a, L: Borrow<[T]> + 'a, V: Borrow<T> + 'a, Message: Clone + 'a, Renderer: Renderer + Renderer + 'a,

fn from(select: Select<'a, T, L, V, Message, Renderer>) -> Self

Converts to this type from the input type.

impl<'a, T, L, V, Message, Renderer> Widget<Message, Theme, Renderer> for Select<'a, T, L, V, Message, Renderer>

where T: Clone + ToString + PartialEq + 'a, L: Borrow<[T]>, V: Borrow<T>, Message: Clone + 'a, Renderer: Renderer + Renderer + 'a,

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn size(&self) -> Size<Length>

Returns the Size of the Widget in lengths.

fn layout( &mut self, tree: &mut Tree, renderer: &Renderer, limits: &Limits, ) -> Node

Returns the layout::Node of the Widget.

fn update( &mut self, tree: &mut Tree, event: &Event, layout: Layout<'_>, cursor: Cursor, _renderer: &Renderer, _clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Message>, _viewport: &Rectangle, )

Processes a runtime Event.

fn mouse_interaction( &self, _tree: &Tree, layout: Layout<'_>, cursor: Cursor, _viewport: &Rectangle, _renderer: &Renderer, ) -> Interaction

Returns the current mouse::Interaction of the Widget.

fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, _style: &Style, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, )

Draws the Widget using the associated Renderer.

fn overlay<'b>( &'b mut self, tree: &'b mut Tree, layout: Layout<'_>, renderer: &Renderer, viewport: &Rectangle, translation: Vector, ) -> Option<Element<'b, Message, Theme, Renderer>>

Returns the overlay of the Widget, if there is any.

fn size_hint(&self) -> Size<Length>

Returns a Size hint for laying out the Widget.

fn children(&self) -> Vec<Tree>

Returns the state Tree of the children of the Widget.

fn diff(&self, tree: &mut Tree)

Reconciles the Widget with the provided Tree.

fn operate( &mut self, _tree: &mut Tree, _layout: Layout<'_>, _renderer: &Renderer, _operation: &mut dyn Operation, )

Applies an Operation to the Widget.