Skip to main content

Select

Struct Select 

Source
pub struct Select { /* private fields */ }
Expand description

Picks one option from a list, shown in a field-like trigger. Enter, Space or an arrow key opens the list with the current option focused; arrows move, Enter picks, Escape closes, and focus returns to the field.

Implementations§

Source§

impl Select

Source

pub fn new( selected: Binding<usize>, options: impl IntoIterator<Item = impl Into<String>>, ) -> Self

A select over options; selected holds the zero-based index of the choice.

Source

pub fn of<T: Clone + PartialEq + 'static>( value: Binding<T>, options: impl IntoIterator<Item = (T, impl Into<String>)>, ) -> Self

A select over values of any type, each with the text that shows it: value holds the value itself, not its position. A value that is not among the options shows nothing until one is picked.

use ravenrs_reactive::State;
use ravenrs_widgets::{Select, Ui};

#[derive(Clone, PartialEq)]
enum Quality {
    Draft,
    Final,
}

let quality = State::new(Quality::Final);
let select = Select::of(quality.binding(), [(Quality::Draft, "Draft"), (Quality::Final, "Final")]);
let mut ui = Ui::new(select, ravenrs_style::Theme::raven_dark());
ui.update();
Source

pub fn searchable(self) -> Self

Opens with a search box that filters the options as you type.

Source

pub fn size(self, size: ButtonSize) -> Self

Sets the height and text size to line up with a Button of the same size (Medium by default).

Source

pub fn fill(self) -> Self

Takes the width of its parent, as other fields of a form do.

Source

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

Sets the width in logical pixels (220 by default).

Source

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

The name screen readers announce, such as “Country”. Inside a crate::FormField, its label is used instead.

Source

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

Turns the control off: it fades, leaves the tab order and ignores input.

Source

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

Shows the value without letting it change; it can still be focused and read.

Trait Implementations§

Source§

impl Debug for Select

Source§

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

Formats the value using the given formatter. Read more
Source§

impl View for Select

Source§

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.
Source§

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Select

§

impl !Send for Select

§

impl !Sync for Select

§

impl !UnwindSafe for Select

§

impl Freeze for Select

§

impl Unpin for Select

§

impl UnsafeUnpin for Select

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V> ViewExt for V
where V: View,

Source§

fn padding(self, padding: impl Into<Insets>) -> Styled<Self>

Adds padding inside the box, in logical pixels.
Source§

fn background(self, fill: impl Into<Fill>) -> Styled<Self>

Paints a background behind the content.
Source§

fn frame(self, width: Option<f32>, height: Option<f32>) -> Styled<Self>

Fixes the width and/or height in logical pixels; None keeps the content size.
Source§

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

Fixes the width in logical pixels.
Source§

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

Fixes the height in logical pixels.
Source§

fn grow(self, grow: f32) -> Styled<Self>

Takes a share of the free space in the parent stack.
Source§

fn stretch(self) -> Styled<Self>

Stretches across the parent stack’s cross axis.
Source§

fn centered(self) -> Styled<Self>

Centers the content inside the box.
Source§

fn tooltip(self, text: impl Into<String>) -> Tooltip<Self>

Shows text above the view while the pointer is over it; see Tooltip.
Source§

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

Draws the view and everything in it at this opacity, from 0.0 to 1.0, easing to it when it changes. Layout and input stay as they are; see Faded.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more