Struct Theme 

pub struct Theme {

    pub scheme: ColorScheme,
    pub palette: Palette,
    pub primary_color: ColorName,
    pub primary_shade_light: usize,
    pub primary_shade_dark: usize,
    pub white: Color,
    pub black: Color,
    pub spacing: Scale,
    pub radius: Scale,
    pub font_size: Scale,
    pub default_radius: Size,
    pub line_height: f32,
    pub font_family: SharedString,
    pub overrides: Overrides,
}

The active theme. Install once with Theme::init, read with theme.

Fields

scheme: ColorScheme

palette: Palette

primary_color: ColorName

The color used for default-variant filled controls.

primary_shade_light: usize

Shade index of the primary color in light / dark mode.

primary_shade_dark: usize

white: Color

black: Color

spacing: Scale

radius: Scale

font_size: Scale

default_radius: Size

Default corner radius for components that don’t specify one.

line_height: f32

font_family: SharedString

overrides: Overrides

Optional CSS-color overrides for the scheme-derived semantic colors and the primary accent. When set, the matching getter returns the override. Set them with the with_* builders (e.g. Theme::dark().with_body(..)).

Implementations

impl Theme

pub fn from_json(source: &str) -> Result<Theme, ThemeJsonError>

Build a theme from a JSON string (see the module docs for the format). Starts from Theme::light/Theme::dark per the scheme key (default dark) and applies each slot as an override.

impl Theme

pub fn preset(name: &str) -> Option<Theme>

Look up a prebuilt theme by name (see PRESET_NAMES).

pub fn catppuccin() -> Theme

Catppuccin Mocha (dark).

pub fn nord() -> Theme

Nord (dark).

pub fn tokyonight() -> Theme

Tokyo Night (dark).

pub fn gruvbox() -> Theme

Gruvbox (dark, hard contrast accents).

pub fn dracula() -> Theme

Dracula (dark).

pub fn solarized_light() -> Theme

Solarized (light).

impl Theme

pub fn light() -> Self

pub fn dark() -> Self

pub fn init(self, cx: &mut App)

Install the theme as the app-global, replacing any existing one.

pub fn with_primary(self, color: impl Into<Hsla>) -> Self

Override the primary accent color.

pub fn with_body(self, color: impl Into<Hsla>) -> Self

Override the app/window background.

pub fn with_surface(self, color: impl Into<Hsla>) -> Self

Override the raised-surface background.

pub fn with_surface_hover(self, color: impl Into<Hsla>) -> Self

Override the subtle hover/recessed fill.

pub fn with_text(self, color: impl Into<Hsla>) -> Self

Override the primary body-text color.

pub fn with_dimmed(self, color: impl Into<Hsla>) -> Self

Override the secondary/dimmed text color.

pub fn with_border(self, color: impl Into<Hsla>) -> Self

Override the default border/divider color.

pub fn with_success(self, color: impl Into<Hsla>) -> Self

Override the success/positive accent.

pub fn with_warning(self, color: impl Into<Hsla>) -> Self

Override the warning accent.

pub fn with_danger(self, color: impl Into<Hsla>) -> Self

Override the danger/destructive accent.

pub fn with_info(self, color: impl Into<Hsla>) -> Self

Override the informational accent.

pub fn spacing(&self, size: Size) -> f32

pub fn radius(&self, size: Size) -> f32

pub fn font_size(&self, size: Size) -> f32

pub fn color(&self, name: ColorName, shade: usize) -> Color

A single shade of a named color.

pub fn primary_shade(&self) -> usize

The active primary-color shade for the current scheme.

pub fn primary(&self) -> Color

The primary color at its scheme-appropriate shade.

pub fn body(&self) -> Color

The app/window background.

pub fn surface(&self) -> Color

Raised surface background (Paper, Card, Menu, …).

pub fn surface_hover(&self) -> Color

A subtly recessed/hover fill.

pub fn text(&self) -> Color

Primary body text.

pub fn dimmed(&self) -> Color

Secondary / dimmed text.

pub fn border(&self) -> Color

Default border / divider color.

pub fn selection(&self) -> Hsla

The wash behind selected text. Every field and editor paints the same one, so it lives here rather than as a primary().alpha(..) open-coded per component — which is how the two that existed had already drifted apart.

pub fn success(&self) -> Color

Success / positive accent (confirmations, valid states).

pub fn warning(&self) -> Color

Warning accent (caution states).

pub fn danger(&self) -> Color

Danger / destructive accent (errors, deletes).

pub fn info(&self) -> Color

Informational accent (notices, hints).

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Theme

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

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Self

Returns the “default value” for a type.

impl Global for Theme