Enum MacBackgroundStyle 

pub enum MacBackgroundStyle {
    Light,
    Dark,
}

macOS AppKit background style (NSBackgroundStyle).

Indicates whether an element’s background is light or dark, allowing child text, icons, and accessories to select high-contrast tints that satisfy WCAG 2.1 AA.

Variants

Light

Background is light (relative luminance L > 0.179). Use dark foreground text.

Dark

Background is dark (relative luminance L <= 0.179). Use light/white foreground text.

Implementations

impl MacBackgroundStyle

pub fn from_color(bg: Color32) -> Self

Resolves MacBackgroundStyle from a background color’s WCAG 2.1 relative luminance.

For neutral / low-saturation backgrounds, applies the normative WCAG 2.1 AA threshold L = 0.179:

• L <= 0.179 => Dark style (white text guarantees >= 4.5:1 contrast)
• L > 0.179 => Light style (dark text guarantees >= 4.5:1 contrast)

For saturated chromatic fills (such as Apple System Blue #007AFF / #0A84FF), macOS AppKit filled controls use high-contrast white text (Dark style), satisfying WCAG 2.1 §1.4.11 / §1.4.3 UI Component / Control AA (>= 3.0:1) with L <= 0.26.

pub fn primary_text_color(&self, theme: &MacTheme) -> Color32

Primary text color guaranteeing >= 4.5:1 WCAG contrast against this background.

• Dark => 100% white (#FFFFFF)
• Light => dark primary label color from Aqua tokens (#262626)

pub fn secondary_text_color(&self, theme: &MacTheme) -> Color32

Secondary text color (subtitles, captions, metadata).

• Dark => 85% white (rgba(255, 255, 255, 0.85))
• Light => dark secondary label color from Aqua tokens (#6E6E73)

pub fn tertiary_text_color(&self, theme: &MacTheme) -> Color32

Tertiary text color (placeholders, disabled hints).

• Dark => 70% white (rgba(255, 255, 255, 0.70))
• Light => dark placeholder text color from Aqua tokens

pub fn primary_text(&self) -> Color32

Standalone primary text color without requiring a MacTheme reference.

pub fn secondary_text(&self) -> Color32

Standalone secondary text color without requiring a MacTheme reference.

pub fn tertiary_text(&self) -> Color32

Standalone tertiary text color without requiring a MacTheme reference.

Trait Implementations

impl Clone for MacBackgroundStyle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MacBackgroundStyle

impl Debug for MacBackgroundStyle

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

Formats the value using the given formatter.

impl Default for MacBackgroundStyle

fn default() -> Self

Returns the “default value” for a type.

impl Eq for MacBackgroundStyle

impl PartialEq for MacBackgroundStyle

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MacBackgroundStyle