Enum Contrast 

#[non_exhaustive]
pub enum Contrast {
    Low,
    Standard,
    High,
}

How legible a theme measured, as a picker reports it.

A measurement carried into the description, which is unusual here and is the one case that earns it: the number comes off the theme’s resolved colours, so the layer that loaded the theme is the only party that has it, and an app re-deriving it would be parsing every theme file a second time to learn what was already known. What a renderer does with it is a badge beside the name.

Ordered worst-first, matching makeover::ContrastTier, so the two sort the same way and an adopter’s match cannot invert an ordering by accident.

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.

Low

Muted text below the 3:1 floor for large text and UI parts.

Standard

Muted text clears 3:1 but not the 4.5:1 bar for normal text.

High

Muted text meets WCAG AA on every panel ground.

Implementations

impl Contrast

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

The machine spelling, for a data attribute or a test.

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

The short mark shown beside a theme’s name.

One spelling for the tree, for ThemeVariant::heading’s reason. These are the marks audiofiles shipped before its picker was described, which is the only implementation that ever drew them.

Standard is not the absence of a mark: a reader scanning a column of badges learns more from three marks than from two and a gap, and “OK” is the honest reading of a theme that clears the UI floor and misses the text one.

Trait Implementations

impl Clone for Contrast

fn clone(&self) -> Contrast

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Contrast

impl Debug for Contrast

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

Formats the value using the given formatter.

impl Display for Contrast

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

Formats the value using the given formatter.

impl Eq for Contrast

impl Hash for Contrast

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 Contrast

fn cmp(&self, other: &Contrast) -> 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 Contrast

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Contrast

fn partial_cmp(&self, other: &Contrast) -> 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 Contrast