Struct Select 

pub struct Select<T> { /* private fields */ }

A controlled popup-backed combo box.

Implementations

impl<T> Select<T>

where T: Clone + PartialEq + 'static,

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

Set the placeholder shown when the current value does not match any option.

pub fn searchable(self) -> Self

Enable in-popup search filtering.

pub fn on_change( self, listener: impl Fn(&T, &mut Window, &mut App) + 'static, ) -> Self

Register a callback invoked with the newly selected option value.

pub fn render_with( self, renderer: impl Fn(SelectRenderState, &Window, &App) -> AnyElement + 'static, ) -> Self

Render the select trigger with caller-owned visuals.

pub fn render_options_with( self, renderer: impl Fn(SelectOptionRenderState<T>, &Window, &App) -> AnyElement + 'static, ) -> Self

Render each popup option row with caller-owned visuals.

pub fn render_popup_with( self, renderer: impl Fn(SelectPopupRenderState, Vec<AnyElement>, &Window, &App) -> AnyElement + 'static, ) -> Self

Render the popup shell with caller-owned visuals around the generated popup children.

pub fn render_search_with( self, renderer: impl Fn(SelectSearchRenderState, AnyElement, &Window, &App) -> AnyElement + 'static, ) -> Self

Render the in-popup search field with caller-owned visuals around the generated input.

Trait Implementations

impl<T> Element for Select<T>

where T: Clone + PartialEq + 'static,

type RequestLayoutState = SelectElementState<T>

The type of state returned from Element::request_layout. A mutable reference to this state is subsequently provided to Element::prepaint and Element::paint.

type PrepaintState = ()

The type of state returned from Element::prepaint. A mutable reference to this state is subsequently provided to Element::paint.

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

If this element has a unique identifier, return it here. This is used to track elements across frames, and will cause a GlobalElementId to be passed to the request_layout, prepaint, and paint methods.

fn source_location(&self) -> Option<&'static Location<'static>>

Source location where this element was constructed, used to disambiguate elements in the inspector and navigate to their source code.

fn request_layout( &mut self, global_id: Option<&GlobalElementId>, _inspector_id: Option<&InspectorElementId>, window: &mut Window, cx: &mut App, ) -> (LayoutId, Self::RequestLayoutState)

Before an element can be painted, we need to know where it’s going to be and how big it is. Use this method to request a layout from Taffy and initialize the element’s state.

fn prepaint( &mut self, _id: Option<&GlobalElementId>, _inspector_id: Option<&InspectorElementId>, bounds: Bounds<Pixels>, request_layout: &mut Self::RequestLayoutState, window: &mut Window, cx: &mut App, ) -> Self::PrepaintState

After laying out an element, we need to commit its bounds to the current frame for hitbox purposes. The state argument is the same state that was returned from Element::request_layout().

fn paint( &mut self, _id: Option<&GlobalElementId>, _inspector_id: Option<&InspectorElementId>, _bounds: Bounds<Pixels>, request_layout: &mut Self::RequestLayoutState, _prepaint: &mut Self::PrepaintState, window: &mut Window, cx: &mut App, )

Once layout has been completed, this method will be called to paint the element to the screen. The state argument is the same state that was returned from Element::request_layout().

fn accessibility_attributes(&self) -> Option<AccessibilityAttributes>

Return the accessibility metadata for this element, if any.

fn into_any(self) -> AnyElement

Convert this element into a dynamically-typed AnyElement.

fn into_boxed_any(self) -> AnyElement

Convert this element into a heap-backed AnyElement that can outlive the current frame arena.

impl<T> IntoElement for Select<T>

where T: Clone + PartialEq + 'static,

type Element = Select<T>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements Element.

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed AnyElement.

fn into_boxed_any_element(self) -> AnyElement

Convert self into a heap-backed AnyElement that can be safely retained across frames.