Struct Picker 

pub struct Picker<D: SelectDelegate + 'static> { /* private fields */ }

A control for picking from a list of options.

This component wraps gpui-component’s Select (dropdown).

The generic parameter D is the delegate type (e.g., Vec<&'static str>, SearchableVec<String>, etc.) that provides the list of options.

Example

// Create state in your view with Vec as the delegate
let country: Entity<SelectState<Vec<&'static str>>> = cx.new(|cx|
    SelectState::new(
        vec!["USA", "Canada", "UK", "Germany"],
        None,  // No initial selection
        window,
        cx,
    )
);

// Subscribe to changes
cx.subscribe(&country, |this, _, event: &SelectEvent<_>, cx| {
    if let SelectEvent::Confirm(value) = event {
        this.on_country_changed(value);
    }
});

// Use in render
Picker::new(&country)
    .placeholder("Select country...")

Implementations

impl<D: SelectDelegate + 'static> Picker<D>

pub fn new(state: &Entity<SelectState<D>>) -> Self

Create a new picker with the given state.

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

Set the placeholder text.

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

Show a clear button when an item is selected.

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

Set the width of the picker.

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

Disable the picker.

Trait Implementations

impl<D: SelectDelegate + 'static> IntoElement for Picker<D>

type Element = Component<Picker<D>>

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.

impl<D: SelectDelegate + 'static> Modifier for Picker<D>

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

Add padding around the view.

fn padding_edges( self, top: f32, leading: f32, bottom: f32, trailing: f32, ) -> Modified<Self>

Add padding to specific edges.

fn frame(self, frame: Frame) -> Modified<Self>

Apply a frame with the specified configuration.

fn frame_size(self, width: f32, height: f32) -> Modified<Self>

Set fixed width and height. Shorthand for frame(Frame::size(w, h)).

fn frame_width(self, width: f32) -> Modified<Self>

Set fixed width only. Shorthand for frame(Frame::width(w)).

fn frame_height(self, height: f32) -> Modified<Self>

Set fixed height only. Shorthand for frame(Frame::height(h)).

fn fixed_size(self, horizontal: bool, vertical: bool) -> Modified<Self>

Prevent the view from expanding beyond its ideal size.

fn aspect_ratio(self, ratio: f32, content_mode: ContentMode) -> Modified<Self>

Constrain the view to a specific aspect ratio.

fn background(self, color: impl Into<Color>) -> Modified<Self>

Set the background color.

fn foreground_color(self, color: impl Into<Color>) -> Modified<Self>

Set the foreground (text) color.

fn tint(self, color: impl Into<Color>) -> Modified<Self>

Set the tint color for interactive elements.

fn corner_radius(self, radius: f32) -> Modified<Self>

Round the corners.

fn border(self, color: impl Into<Color>, width: f32) -> Modified<Self>

Add a border.

fn shadow(self, radius: f32) -> Modified<Self>

Add a shadow.

fn shadow_with( self, radius: f32, color: impl Into<Color>, x: f32, y: f32, ) -> Modified<Self>

Add a shadow with full configuration.

fn opacity(self, value: f32) -> Modified<Self>

Set the opacity.

fn hidden(self, is_hidden: bool) -> Modified<Self>

Hide the view.

fn disabled(self, is_disabled: bool) -> Modified<Self>

Disable interaction.

fn scale(self, value: f32) -> Modified<Self>

Apply a scale transform.

fn on_tap_gesture( self, id: impl Into<SharedString>, handler: impl Fn() + 'static, ) -> Tappable<Self>

Add a tap gesture handler.

fn on_tap_gesture_with( self, id: impl Into<SharedString>, handler: impl Fn(&ClickEvent, &mut Window, &mut App) + 'static, ) -> Tappable<Self>

Add a tap gesture handler with access to the event.

impl<D: SelectDelegate + 'static> RenderOnce for Picker<D>

fn render(self, _window: &mut Window, _cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to Render::render() method which takes a mutable reference.