Skip to main content

DefaultTheme

Struct DefaultTheme 

Source
pub struct DefaultTheme {
Show 24 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 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§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

Examples found in repository?
examples/quickstart.rs (line 4)
3fn main() -> Result<()> {
4    let theme = DefaultTheme::light();
5
6    let content = Stack::vertical()
7        .spacing(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

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::dynamic("Draft", move || status_state.borrow().status())
106        .theme(theme)
107        .color(theme.palette.text_muted);
108
109    let enabled_state = Rc::clone(&state);
110    let submit_state = Rc::clone(&state);
111    let submit = Button::new("Save profile")
112        .theme(theme)
113        .enabled_when(move || enabled_state.borrow().can_submit())
114        .on_press_with_ctx(move |ctx| {
115            submit_state.borrow_mut().submissions += 1;
116            refresh_window(ctx);
117        });
118
119    let form = Stack::vertical()
120        .spacing(12.0)
121        .alignment(Alignment::Start)
122        .with_child(
123            Label::new("Create a profile")
124                .theme(theme)
125                .font_size(26.0)
126                .line_height(32.0)
127                .color(theme.palette.text),
128        )
129        .with_child(
130            Label::new("Enter a name, password, and local appointment time.")
131                .theme(theme)
132                .color(theme.palette.text_muted),
133        )
134        .with_child(name)
135        .with_child(password)
136        .with_child(scheduled_for)
137        .with_child(submit)
138        .with_child(status);
139
140    let card = Surface::panel(form).theme(theme).padding(Insets::all(20.0));
141    let root = Surface::window(card)
142        .theme(theme)
143        .padding(Insets::all(24.0))
144        .fill();
145
146    App::new()
147        .window(Window::new("Stateful SUI Form").root(root))
148        .run()
149}
Source

pub fn high_contrast() -> DefaultTheme

Source

pub fn void() -> DefaultTheme

The Mesh 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

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 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)

The Mesh soft pair for a tone: a translucent wash to fill with and the status-hued ink that stays legible on it (--sm-*-soft / --sm-*-text). Use for badges, callouts and selected rows; the solid pair from Self::semantic_tone_colors is for filled controls.

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 = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

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