Skip to main content

DefaultTheme

Struct DefaultTheme 

Source
pub struct DefaultTheme {
Show 25 fields pub fonts: ThemeFontFamilies, pub colors: ThemeColors, pub density: ThemeDensity, pub control_size: Option<ControlSize>, pub spacing: f32, pub breakpoints: ThemeBreakpoints, pub containers: ThemeContainers, pub text: ThemeTextScale, pub font_weights: ThemeFontWeights, pub tracking: ThemeTracking, pub leading: ThemeLeading, pub radius: ThemeRadii, pub shadows: ThemeShadows, pub glows: ThemeGlows, pub blur: ThemeBlurScale, pub perspective: ThemePerspective, pub aspect: ThemeAspectRatios, pub motion: ThemeMotion, pub hdr: HdrThemeTokens, pub palette: ControlPalette, pub surfaces: SurfacePalette, pub decorative: DecorativePalette, pub typography: ControlTypography, pub interaction: ControlStateMetrics, pub metrics: ControlMetrics,
}

Fields§

§fonts: ThemeFontFamilies§colors: ThemeColors§density: ThemeDensity§control_size: Option<ControlSize>

Contextual authored size, when this theme copy is scoped to an interface surface.

§spacing: f32§breakpoints: ThemeBreakpoints§containers: ThemeContainers§text: ThemeTextScale§font_weights: ThemeFontWeights§tracking: ThemeTracking§leading: ThemeLeading§radius: ThemeRadii§shadows: ThemeShadows§glows: ThemeGlows

Live-signal glow halos (--sm-glow-*): empty in Light, damped in the true-black theme. Paint with paint_theme_shadow.

§blur: ThemeBlurScale§perspective: ThemePerspective§aspect: ThemeAspectRatios§motion: ThemeMotion§hdr: HdrThemeTokens§palette: ControlPalette§surfaces: SurfacePalette§decorative: DecorativePalette

Derived roles for the categorical decorative hues.

§typography: ControlTypography§interaction: ControlStateMetrics§metrics: ControlMetrics

Implementations§

Source§

impl DefaultTheme

Source

pub fn new() -> DefaultTheme

Source

pub fn sui() -> DefaultTheme

SUI’s branded default theme.

Source

pub fn light() -> DefaultTheme

Pure white and gray surfaces with the vibrant SUI azure accent.

Examples found in repository?
examples/quickstart.rs (line 4)
3fn main() -> Result<()> {
4    let theme = DefaultTheme::light();
5
6    let content = Stack::vertical()
7        .gap(12.0)
8        .alignment(Alignment::Start)
9        .with_child(
10            Label::new("Your first SUI window")
11                .theme(theme)
12                .font_size(24.0)
13                .line_height(30.0)
14                .color(theme.palette.text),
15        )
16        .with_child(
17            Label::new("Widgets are retained Rust values arranged into one tree.")
18                .theme(theme)
19                .color(theme.palette.text_muted),
20        )
21        .with_child(
22            Button::new("Say hello")
23                .theme(theme)
24                .on_press(|| println!("Hello from SUI!")),
25        );
26
27    let root = Surface::window(content)
28        .theme(theme)
29        .padding(Insets::all(24.0))
30        .fill();
31
32    App::new()
33        .window(Window::new("SUI Quickstart").root(root))
34        .run()
35}
Source

pub fn neutral() -> DefaultTheme

A neutral light theme for serious, professional interfaces without an application-specific color preference.

Source

pub fn neutral_dark() -> DefaultTheme

Dark companion to Self::neutral.

Source

pub fn dark() -> DefaultTheme

Faintly blue-tinted dark surfaces with the SUI azure accent.

Examples found in repository?
examples/rich_document.rs (line 4)
3fn main() -> Result<()> {
4    let theme = DefaultTheme::dark();
5    let document = RichDocumentModel::from_markdown(
6        r#"# Deployment report
7
8SUI keeps this document selectable across blocks. Follow the [runbook](https://example.test/runbook) for details.
9
10- [x] Build artifacts
11- [x] Run tests
12- [ ] Publish release
13
14```rust
15let status = deploy().await?;
16assert!(status.ready());
17```
18"#,
19    );
20
21    let mut operation = RichExtensionBlock::new("operation-log", "Release operation");
22    operation.status = RichDocumentStatus::Running;
23    operation.summary = Some("2 of 3 stages complete".into());
24    operation.body = "build   complete\ntest    complete\npublish running".into();
25    document.append_extension(operation);
26
27    let view = RichDocumentView::new(document)
28        .theme(theme)
29        .on_link(|destination| println!("Application URL policy received: {destination}"));
30    let root = Surface::window(ScrollView::vertical(view).retain_content_layer())
31        .theme(theme)
32        .padding(Insets::all(24.0))
33        .fill();
34
35    App::new()
36        .window(Window::new("SUI Rich Document").root(root))
37        .run()
38}
More examples
Hide additional examples
examples/stateful_form.rs (line 70)
69fn main() -> Result<()> {
70    let theme = DefaultTheme::dark();
71    let state = Rc::new(RefCell::new(FormState::default()));
72
73    let name_state = Rc::clone(&state);
74    let name = TextInput::new("Display name")
75        .placeholder("Ada Lovelace")
76        .min_width(360.0)
77        .theme(theme)
78        .on_change_with_ctx(move |ctx, value| {
79            name_state.borrow_mut().name = value;
80            refresh_window(ctx);
81        });
82
83    let password_state = Rc::clone(&state);
84    let password = PasswordInput::new("Password")
85        .placeholder("At least eight characters")
86        .min_width(360.0)
87        .theme(theme)
88        .on_change_with_ctx(move |ctx, value| {
89            password_state.borrow_mut().password = value;
90            refresh_window(ctx);
91        });
92
93    let initial_schedule = state.borrow().scheduled_for.clone();
94    let schedule_state = Rc::clone(&state);
95    let scheduled_for = DateTimeInput::new("Scheduled for")
96        .value(initial_schedule)
97        .min_width(360.0)
98        .theme(theme)
99        .on_change_with_ctx(move |ctx, value| {
100            schedule_state.borrow_mut().scheduled_for = value;
101            refresh_window(ctx);
102        });
103
104    let status_state = Rc::clone(&state);
105    let status = Label::new("Draft")
106        .text_when(move || status_state.borrow().status())
107        .theme(theme)
108        .color(theme.palette.text_muted);
109
110    let enabled_state = Rc::clone(&state);
111    let submit_state = Rc::clone(&state);
112    let submit = Button::new("Save profile")
113        .theme(theme)
114        .enabled_when(move || enabled_state.borrow().can_submit())
115        .on_press_with_ctx(move |ctx| {
116            submit_state.borrow_mut().submissions += 1;
117            refresh_window(ctx);
118        });
119
120    let form = Stack::vertical()
121        .gap(12.0)
122        .alignment(Alignment::Start)
123        .with_child(
124            Label::new("Create a profile")
125                .theme(theme)
126                .font_size(26.0)
127                .line_height(32.0)
128                .color(theme.palette.text),
129        )
130        .with_child(
131            Label::new("Enter a name, password, and local appointment time.")
132                .theme(theme)
133                .color(theme.palette.text_muted),
134        )
135        .with_child(name)
136        .with_child(password)
137        .with_child(scheduled_for)
138        .with_child(submit)
139        .with_child(status);
140
141    let card = Surface::panel(form).theme(theme).padding(Insets::all(20.0));
142    let root = Surface::window(card)
143        .theme(theme)
144        .padding(Insets::all(24.0))
145        .fill();
146
147    App::new()
148        .window(Window::new("Stateful SUI Form").root(root))
149        .run()
150}
Source

pub fn high_contrast() -> DefaultTheme

Source

pub fn void() -> DefaultTheme

The true-black OLED theme (“Void”): borders instead of shadows, dimmed whites, damped glows. Alias for Self::high_contrast.

Source

pub fn compact() -> DefaultTheme

Source

pub fn comfortable() -> DefaultTheme

Source

pub fn touch() -> DefaultTheme

Source

pub fn from_colors(colors: ThemeColors) -> DefaultTheme

Build a theme from source colors, deriving every palette role. The built-in presets cache their result; call this for custom palettes.

Source

pub fn with_density(self, density: ThemeDensity) -> DefaultTheme

Source

pub fn with_size(self, size: ControlSize) -> DefaultTheme

Apply contextual interface sizing without changing the text-scale ramp.

The existing density tiers provide the mature detailed metric ladders behind Small, Medium, and Large. The authored size contract then normalizes the primary control, row, icon, and control-text tokens while leaving the caller’s text ramp intact.

Source

pub fn sync_derived_fields(&mut self)

Source

pub fn text_style(&self, color: Color) -> TextStyle

Source

pub fn serif_text_style(&self, color: Color) -> TextStyle

Build a text style using the theme’s serif family preference stack.

Source

pub fn mono_text_style(&self, color: Color) -> TextStyle

Build a text style using the theme’s monospace family preference stack.

Source

pub fn semantic_tone_colors(&self, tone: SemanticTone) -> (Color, Color)

Source

pub fn glow_for_output( &self, tone: GlowTone, output: Option<OutputColorRange>, ) -> ThemeShadow

The theme’s tone glow as it should look on output.

Where the theme’s HDR mode and the output allow it, each halo takes the HDR variant of the tone’s color, as bright as an emissive indicator may be, or its wide-gamut variant on a wide-gamut output, keeping the halo’s own alpha. Elsewhere, and whenever the theme turns HDR effects off, the glow is the theme’s token. Light themes have no glow.

Source

pub fn tone_roles(&self, tone: SemanticTone) -> ToneRoles

The complete role set for a semantic tone. Neutral resolves to the neutral button face: white with an outline in light themes, a raised fill in dark themes, always with full-strength ink.

Source

pub fn semantic_tone_color(&self, tone: SemanticTone) -> Color

Source

pub fn semantic_tone_text_color(&self, tone: SemanticTone) -> Color

Source

pub fn semantic_tone_soft_colors(&self, tone: SemanticTone) -> (Color, Color)

Soft pair for an explicitly semantic tone: a restrained wash to fill with and tone-hued ink that stays legible on it. Use for badges and callouts; selected rows use the neutral selection role. The solid pair from Self::semantic_tone_colors is for filled controls.

Source

pub fn for_disabled_control(self) -> DefaultTheme

This theme as a disabled control draws with it: text and placeholders take the disabled ink, fills fade toward the control tier, and borders and accents lose strength, so a widget that paints with the result looks disabled without colors of its own.

Source

pub fn body_text_style(&self) -> TextStyle

Source

pub fn placeholder_text_style(&self) -> TextStyle

Source

pub fn button_text_style(&self) -> TextStyle

Trait Implementations§

Source§

impl Clone for DefaultTheme

Source§

fn clone(&self) -> DefaultTheme

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for DefaultTheme

Source§

impl Debug for DefaultTheme

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for DefaultTheme

Source§

fn default() -> DefaultTheme

Returns the “default value” for a type. Read more
Source§

impl PartialEq for DefaultTheme

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for DefaultTheme

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send> ⓘ

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ThemeExtension for T
where T: Any + Send + Sync,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<T> WasmNotSend for T
where T: Send,

Source§

impl<T> WasmNotSendSync for T

Source§

impl<T> WasmNotSync for T
where T: Sync,

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more