Struct RoleColor 

pub struct RoleColor {
    pub color: Hsla,
    pub foreground: Hsla,
    pub hover_mix: f32,
    /* private fields */
}

A semantic color role (accent, default, success, warning, danger).

v3 removed numbered scales; a role carries only its base value and readable foreground, and every other shade is derived.

Fields

color: Hsla

e.g. --accent.

foreground: Hsla

e.g. --accent-foreground.

hover_mix: f32

Weight of foreground in the *-hover mix. 0.10 for the status and accent roles, 0.04 for default.

Implementations

impl RoleColor

pub fn new(color: Hsla, foreground: Hsla) -> Self

pub fn with_hover_mix(self, hover_mix: f32) -> Self

default mixes only 4% of its foreground on hover.

pub fn with_soft_mix(self, soft: f32, soft_hover: f32) -> Self

Sets the shares of the role color in --role-soft and --role-soft-hover (default sits at 50/60, the rest at 15/20 in light and 12/16 in dark for the cooler roles).

pub fn with_soft_foreground_mix(self, color: f32, foreground: f32) -> Self

--role-soft-foreground: color-mix(in oklab, var(--role) C%, var(--foreground) F%)

pub fn with_vibrant_palette(self, vibrant: bool) -> Self

Opts this role into [data-vibrant-palette="true"]. Set through crate::ThemeBuilder::vibrant_palette, which fans the flag out over every role at once, the way the attribute selector does.

pub fn is_vibrant_palette(&self) -> bool

Whether this role resolves its soft foreground with the vibrant weights.

pub fn with_soft_foreground_role(self) -> Self

--default-soft-foreground: var(--default-foreground)

pub fn hover(&self) -> Hsla

--color-accent-hover: color-mix(in oklab, var(--accent) 90%, var(--accent-foreground) 10%)

pub fn soft(&self) -> Hsla

--color-accent-soft: color-mix(in oklab, var(--accent) 15%, transparent)

pub fn soft_hover(&self) -> Hsla

--color-accent-soft-hover: color-mix(in oklab, var(--accent) 20%, transparent)

pub fn soft_foreground(&self, page_foreground: Hsla) -> Hsla

--color-accent-soft-foreground: color-mix(in oklab, var(--accent) 70%, var(--foreground) 30%)

The mixing roles blend against the page foreground, so pass the live ThemeColors::foreground — a ThemeBuilder::foreground override then flows through without rebuilding the theme.

pub fn with_alpha(&self, alpha: f32) -> Hsla

Trait Implementations

impl Clone for RoleColor

fn clone(&self) -> RoleColor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RoleColor

impl Debug for RoleColor

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

Formats the value using the given formatter.