Enum ThemeVariant 

#[non_exhaustive]
pub enum ThemeVariant {
    Light,
    Dark,
    HighContrast,
}

Which ambient mode a theme is written for.

The vocabulary’s own spelling of what makeover calls a theme’s variant, and the duplication is deliberate rather than an oversight. This crate has no dependencies by charter — it emits nothing, reads nothing and resolves nothing — so it cannot take the crate that owns the file format, and a renderer that must group a picker needs the three groups as values.

The two are kept in step by the app that converts between them, which is a three-arm match at each adopter and the price of the layering. If a fourth mode is ever authored, this enum and makeover::Variant move together.

Three, not two: one shipped theme is high contrast, and an app matching on light-or-dark alone files it under the wrong one.

Added 0.38.0.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Light

Written for a light ambient mode.

Dark

Written for a dark ambient mode.

HighContrast

Written to be legible before it is pretty.

Implementations

impl ThemeVariant

pub const fn as_str(self) -> &'static str

The machine spelling, matching the theme file’s own meta.variant.

A data attribute, a stored value, a test assertion. Not a heading: what a group is called on screen is heading.

pub const fn heading(self) -> &'static str

What the group of themes in this variant is called on screen.

Here rather than at each renderer, which is the whole argument for the member existing: three renderers picking their own headings is one picker reading three ways, and the spellings below are the ones goingson’s shipped picker used before it was described.

Trait Implementations

impl Clone for ThemeVariant

fn clone(&self) -> ThemeVariant

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ThemeVariant

impl Debug for ThemeVariant

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

Formats the value using the given formatter.

impl Display for ThemeVariant

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

Formats the value using the given formatter.

impl Eq for ThemeVariant

impl Hash for ThemeVariant

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ThemeVariant

fn cmp(&self, other: &ThemeVariant) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for ThemeVariant

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ThemeVariant

fn partial_cmp(&self, other: &ThemeVariant) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for ThemeVariant