Theming
Freya has built-in support for Theming.
⚠️ Currently, extending the base theme is not supported.
Accessing the current theme
You can access the whole current theme via the use_get_theme
hook.
#![allow(unused)] fn main() { fn app() -> Element { rsx!( ThemeProvider { Component { } } ) } #[allow(non_snake_case)] fn Component() -> Element { let theme = use_get_theme(); let button_theme = &theme.button; rsx!( rect { background: "{button_theme.background}", } ) } }
Custom default theme
By default, the selected theme is LIGHT_THEME
. You can use the alternative, DARK_THEME
.
#![allow(unused)] fn main() { fn app() -> Element { rsx!( ThemeProvider { theme: LIGHT_THEME, Component { } } ) } #[allow(non_snake_case)] fn Component() -> Element { let theme = use_get_theme(); let button_theme = &theme.button; rsx!( rect { background: "{button_theme.background}", } ) } }
Change theme globally
Changing the selected theme at runtime is possible by using the use_theme
hook.
#![allow(unused)] fn main() { fn app() -> Element { rsx!( ThemeProvider { Component { } } ) } #[allow(non_snake_case)] fn Component() -> Element { let mut theme = use_theme(); let onclick = move |_| { *theme.write() = LIGHT_THEME; }; rsx!( Button { onclick, label { "Use Light theme" } } ) } }
Custom theme
Themes can be built from scratch or extended from others, like here with LIGHT_THEME
:
#![allow(unused)] fn main() { const CUSTOM_THEME: Theme = Theme { button: ButtonTheme { background: "rgb(230, 0, 0)", hover_background: "rgb(150, 0, 0)", font_theme: FontTheme { color: "white" } }, ..LIGHT_THEME }; fn app() -> Element { rsx!( ThemeProvider { theme: CUSTOM_THEME, rect { width: "100%", height: "100%", Button { label { "Report" } } } } ) } }