Struct Theme 

#[non_exhaustive]
pub struct Theme {
    pub mode: ThemeMode,
    pub light: ThemeConfig,
    pub dark: ThemeConfig,
    pub radius: Pixels,
    pub ui_font_size: Pixels,
    pub code_font_size: Pixels,
    pub reduce_motion: ReduceMotion,
    pub motion: MotionTokens,
    pub pointer_cursors: bool,
    pub shadow: bool,
    pub touch: bool,
    /* private fields */
}

The gpui-cn theme, a GPUI global.

Public fields are the inputs. Edit them through Theme::update, which re-derives the tokens, projects them onto gpui_base::Theme, applies the motion preference, and refreshes every window. Components read the derived ThemeTokens through ActiveTheme::theme.

gpui-cn owns gpui_base::Theme the same way gpui-component does: every change is projected onto it, and nothing reads it back.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

mode: ThemeMode

Which config is active.

light: ThemeConfig

The config used in light appearance.

dark: ThemeConfig

The config used in dark appearance.

radius: Pixels

The base corner radius. The radius scale derives from it.

ui_font_size: Pixels

The interface font size. It is also the window rem size, so it is the zoom control for everything on the rem scale.

code_font_size: Pixels

The code font size.

reduce_motion: ReduceMotion

Whether motion is reduced.

motion: MotionTokens

Durations and curves components animate with.

pointer_cursors: bool

Pointer cursor on interactive controls. Off keeps the platform arrow on buttons. Links always use the pointer.

shadow: bool

Whether elevated surfaces cast shadows.

touch: bool

Whether a finger is the pointer. On by default on iOS and Android. Controls and rows grow to the 44pt hit target of Apple’s Human Interface Guidelines, text takes its body size, and nothing shows a hover state, since a finger cannot hover.

Implementations

impl Theme

pub fn global(cx: &App) -> &Self

The theme global. Panics before crate::init.

pub fn holds_still(cx: &App) -> bool

Whether a looping animation (a spinner, a pulse, a sweep) holds still: under reduced motion, or with every motion duration at zero.

pub fn tokens(&self) -> &ThemeTokens

The derived tokens for the active appearance.

pub fn active_tokens(&self) -> &ThemeTokens

The tokens a component reads: the scope’s while it draws inside a ThemeScope, the active appearance’s otherwise.

pub fn set_scope( cx: &mut App, key: impl Into<SharedString>, config: ThemeConfig, )

Registers or replaces the scope key: a part of the window drawn on its own surface and ink, such as a terminal with its own colors. Its tokens derive from config with this theme’s sizes, and its appearance follows the surface: dark when the surface’s OKLab lightness is under one half. They derive again whenever the theme changes, so a font size change reaches them too.

pub fn scope(&self, key: &str) -> Option<&ThemeTokens>

The tokens of the scope key, if it is registered.

pub fn appearance(&self) -> ThemeAppearance

The active appearance after resolving mode.

pub fn is_dark(&self) -> bool

Whether the active appearance is dark.

pub fn active_config(&self) -> &ThemeConfig

The config for the active appearance.

pub fn update<R>(cx: &mut App, edit: impl FnOnce(&mut Theme) -> R) -> R

Edits the theme, then re-derives tokens, projects them onto base, applies the motion preference, and refreshes every window.

pub fn change(mode: ThemeMode, cx: &mut App)

Switches the mode.

pub fn sync_system_appearance(window: Option<&Window>, cx: &mut App)

Reads the system appearance again. gpui-cn’s root layer calls this when the window appearance changes; it matters only in ThemeMode::System.

pub fn set_ui_font_size(cx: &mut App, size: Pixels)

Sets both font sizes at once, keeping their ratio.

Trait Implementations

impl Global for Theme