Struct ThemeMode

Source

pub struct ThemeMode {Show 27 fields
    pub defaults: ThemeDefaults,
    pub text_scale: TextScale,
    pub window: WindowTheme,
    pub button: ButtonTheme,
    pub input: InputTheme,
    pub checkbox: CheckboxTheme,
    pub menu: MenuTheme,
    pub tooltip: TooltipTheme,
    pub scrollbar: ScrollbarTheme,
    pub slider: SliderTheme,
    pub progress_bar: ProgressBarTheme,
    pub tab: TabTheme,
    pub sidebar: SidebarTheme,
    pub toolbar: ToolbarTheme,
    pub status_bar: StatusBarTheme,
    pub list: ListTheme,
    pub popover: PopoverTheme,
    pub splitter: SplitterTheme,
    pub separator: SeparatorTheme,
    pub switch: SwitchTheme,
    pub dialog: DialogTheme,
    pub spinner: SpinnerTheme,
    pub combo_box: ComboBoxTheme,
    pub segmented_control: SegmentedControlTheme,
    pub card: CardTheme,
    pub expander: ExpanderTheme,
    pub link: LinkTheme,
}

Expand description

A single light or dark theme variant containing all visual properties.

Composes defaults, per-widget structs, and optional text scale into one coherent set. Empty sub-structs are omitted from serialization to keep TOML files clean.

§Examples

use native_theme::theme::ThemeMode;
use native_theme::color::Rgba;

let mut variant = ThemeMode::default();
variant.defaults.accent_color = Some(Rgba::rgb(0, 120, 215));
variant.defaults.font.family = Some("Inter".into());
assert!(!variant.is_empty());

Fields§

§defaults: ThemeDefaults

Global defaults inherited by all widgets.

§text_scale: TextScale

Per-role text scale overrides.

§window: WindowTheme

Window chrome: background, title bar, radius, shadow.

§button: ButtonTheme

Push button: colors, sizing, spacing, geometry.

§input: InputTheme

Single-line and multi-line text input fields.

§checkbox: CheckboxTheme

Checkbox and radio button indicator geometry.

§menu: MenuTheme

Popup and context menu appearance.

§tooltip: TooltipTheme

Tooltip popup appearance.

§scrollbar: ScrollbarTheme

Scrollbar colors and geometry.

§slider: SliderTheme

Slider control colors and geometry.

§progress_bar: ProgressBarTheme

Progress bar colors and geometry.

§tab: TabTheme

Tab bar colors and sizing.

§sidebar: SidebarTheme

Sidebar panel background and foreground colors.

§toolbar: ToolbarTheme

Toolbar sizing, spacing, and font.

§status_bar: StatusBarTheme

Status bar font.

§list: ListTheme

List and table colors and row geometry.

§popover: PopoverTheme

Popover / dropdown panel appearance.

§splitter: SplitterTheme

Splitter handle width.

§separator: SeparatorTheme

Separator line color.

§switch: SwitchTheme

Toggle switch track, thumb, and geometry.

§dialog: DialogTheme

Dialog sizing, spacing, button order, and title font.

§spinner: SpinnerTheme

Spinner / indeterminate progress indicator.

§combo_box: ComboBoxTheme

ComboBox / dropdown trigger sizing.

§segmented_control: SegmentedControlTheme

Segmented control sizing.

§card: CardTheme

Card / container colors and geometry.

§expander: ExpanderTheme

Expander / disclosure row geometry.

§link: LinkTheme

Hyperlink colors and underline setting.

Implementations§

Source §

impl ThemeMode

Source

pub fn merge(&mut self, overlay: &Self)

Merge an overlay into this value. Some fields in the overlay replace the corresponding fields in self; None fields are left unchanged. Nested structs are merged recursively.

Source

pub fn is_empty(&self) -> bool

Returns true if all fields are at their default (None/empty) state.

Source §

impl ThemeMode

Source

pub fn into_resolved(self, ctx: &ResolutionContext) -> Result<ResolvedTheme>

Resolve all inheritance rules and validate in one step.

This is the recommended way to convert a ThemeMode into a ResolvedTheme. It applies every inheritance rule (including the ctx.button_order platform default) followed by validate_with_dpi(), ensuring no fields are left unresolved.

§Arguments

ctx – resolution-time inputs captured once per theme-build. Use ResolutionContext::from_system for OS-detected values (Linux/Windows ≈ 96 DPI, macOS = 72 DPI, button order per desktop environment), or ResolutionContext::for_tests for deterministic test values (96 DPI, PrimaryRight, no icon_theme). The resolve_system() shortcut wraps the from_system() case.

§Errors

Returns crate::Error::ResolutionIncomplete if any fields remain None after resolution, or crate::Error::ResolutionInvalid if range checks fail.

§Examples

use native_theme::resolve::ResolutionContext;
use native_theme::theme::Theme;

let theme = Theme::preset("dracula")?;
let variant = theme.dark.ok_or("no dark variant")?;
let resolved = variant.into_resolved(&ResolutionContext::from_system())?;
// Or use the zero-argument shortcut:
// let resolved = variant.resolve_system()?;
let _accent = resolved.defaults.accent_color;

Source

pub fn resolve_system(self) -> Result<ResolvedTheme>

Resolve using the OS-detected context.

Equivalent to self.into_resolved(&ResolutionContext::from_system()).

Placed on ThemeMode (not Theme) because Theme has both light and dark variants — variant selection must be explicit via Theme::into_variant. See plan 94-02 objective for the deviation rationale from gap doc §G7 step 4.

§Errors

Returns crate::Error::ResolutionIncomplete if any fields remain None after resolution, or crate::Error::ResolutionInvalid if range checks fail.

§Examples

use native_theme::theme::{ColorMode, Theme};

let theme = Theme::preset("dracula")?;
let variant = theme.into_variant(ColorMode::Dark)?;
let resolved = variant.resolve_system()?;
let _accent = resolved.defaults.accent_color;