Skip to main content

Selector

Enum Selector 

Source
pub enum Selector {
    Segmented,
    Toggle,
    Tabs,
}
Expand description

A control that picks between things.

Three, because three distinct behaviours are in play and collapsing any two loses something. A segmented control picks a value; a tab picks a pane; a toggle picks nothing and simply holds itself on or off.

Variants§

§

Segmented

Exactly one of N, and the options abut.

§

Toggle

Independent on or off, on its own.

§

Tabs

Navigation between panes. The folder semantic.

Implementations§

Source§

impl Selector

Source

pub const fn chosen(self) -> Depth

How the chosen option sits.

Held in for a segmented control and a toggle, which is the same shape pressing produces and the whole economy of the idiom: one appearance, two reasons to wear it. A tab is the exception, because the selected folder tab comes forward to join the pane it opens.

Source

pub const fn unchosen(self) -> Depth

How the options that were not picked sit.

Added 0.3.0. Describing only Selector::chosen left the unchosen option falling through to Depth::Flat, which says it is level with the strip it sits in, and no renderer emitted anything for it. That is wrong in both directions and goingson proved it: its unchosen tabs are recessed by hand, and being recessed is why the chosen one reads as coming forward. Against a flat strip, a raised chosen tab is a bevel drawn on the strip’s own colour, which is a much weaker folder effect than the contrast the idiom is named after.

Each member is the inverse of its chosen state, which is the whole content of “picked” once colour is deferred:

  • Tabs recede, so the chosen one comes forward.
  • A segment and a toggle stand up, so the chosen one is held in.
Source

pub const fn abutting(self) -> bool

Whether the options touch.

The gap is the entire difference between a segmented control and a row of buttons that happen to sit near each other, which is what audiofiles’ segmented_control says in its own comment and why it zeroes the spacing by hand.

Trait Implementations§

Source§

impl Clone for Selector

Source§

fn clone(&self) -> Selector

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for Selector

Source§

impl Debug for Selector

Source§

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

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

impl Eq for Selector

Source§

impl Hash for Selector

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for Selector

Source§

fn eq(&self, other: &Selector) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Selector

Auto Trait Implementations§

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

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
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.