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: ThemeGlowsLive-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: DecorativePaletteDerived roles for the categorical decorative hues.
typography: ControlTypography§interaction: ControlStateMetrics§metrics: ControlMetricsImplementations§
Source§impl DefaultTheme
impl DefaultTheme
pub fn new() -> DefaultTheme
Sourcepub fn sui() -> DefaultTheme
pub fn sui() -> DefaultTheme
SUI’s branded default theme.
Sourcepub fn light() -> DefaultTheme
pub fn light() -> DefaultTheme
Pure white and gray surfaces with the vibrant SUI azure accent.
Examples found in repository?
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}Sourcepub fn neutral() -> DefaultTheme
pub fn neutral() -> DefaultTheme
A neutral light theme for serious, professional interfaces without an application-specific color preference.
Sourcepub fn neutral_dark() -> DefaultTheme
pub fn neutral_dark() -> DefaultTheme
Dark companion to Self::neutral.
Sourcepub fn dark() -> DefaultTheme
pub fn dark() -> DefaultTheme
Faintly blue-tinted dark surfaces with the SUI azure accent.
Examples found in repository?
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
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}pub fn high_contrast() -> DefaultTheme
Sourcepub fn void() -> DefaultTheme
pub fn void() -> DefaultTheme
The true-black OLED theme (“Void”): borders instead of shadows, dimmed
whites, damped glows. Alias for Self::high_contrast.
pub fn compact() -> DefaultTheme
pub fn comfortable() -> DefaultTheme
pub fn touch() -> DefaultTheme
Sourcepub fn from_colors(colors: ThemeColors) -> DefaultTheme
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.
pub fn with_density(self, density: ThemeDensity) -> DefaultTheme
Sourcepub fn with_size(self, size: ControlSize) -> DefaultTheme
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.
pub fn sync_derived_fields(&mut self)
pub fn text_style(&self, color: Color) -> TextStyle
Sourcepub fn serif_text_style(&self, color: Color) -> TextStyle
pub fn serif_text_style(&self, color: Color) -> TextStyle
Build a text style using the theme’s serif family preference stack.
Sourcepub fn mono_text_style(&self, color: Color) -> TextStyle
pub fn mono_text_style(&self, color: Color) -> TextStyle
Build a text style using the theme’s monospace family preference stack.
pub fn semantic_tone_colors(&self, tone: SemanticTone) -> (Color, Color)
Sourcepub fn glow_for_output(
&self,
tone: GlowTone,
output: Option<OutputColorRange>,
) -> ThemeShadow
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.
Sourcepub fn tone_roles(&self, tone: SemanticTone) -> ToneRoles
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.
pub fn semantic_tone_color(&self, tone: SemanticTone) -> Color
pub fn semantic_tone_text_color(&self, tone: SemanticTone) -> Color
Sourcepub fn semantic_tone_soft_colors(&self, tone: SemanticTone) -> (Color, Color)
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.
Sourcepub fn for_disabled_control(self) -> DefaultTheme
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.
pub fn body_text_style(&self) -> TextStyle
pub fn placeholder_text_style(&self) -> TextStyle
Trait Implementations§
Source§impl Clone for DefaultTheme
impl Clone for DefaultTheme
Source§fn clone(&self) -> DefaultTheme
fn clone(&self) -> DefaultTheme
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreimpl Copy for DefaultTheme
Source§impl Debug for DefaultTheme
impl Debug for DefaultTheme
Source§impl Default for DefaultTheme
impl Default for DefaultTheme
Source§fn default() -> DefaultTheme
fn default() -> DefaultTheme
Source§impl PartialEq for DefaultTheme
impl PartialEq for DefaultTheme
impl StructuralPartialEq for DefaultTheme
Auto Trait Implementations§
impl Forget for DefaultTheme
impl Freeze for DefaultTheme
impl Move for DefaultTheme
impl RefUnwindSafe for DefaultTheme
impl Send for DefaultTheme
impl Sync for DefaultTheme
impl Unpin for DefaultTheme
impl UnsafeUnpin for DefaultTheme
impl UnwindSafe for DefaultTheme
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
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>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
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)
fn as_any(&self) -> &(dyn Any + 'static)
&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)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.