From 18fb74f20092b2703a90afdb01f39754445998da Mon Sep 17 00:00:00 2001 From: Héctor Ramón Jiménez Date: Wed, 9 Nov 2022 04:05:31 +0100 Subject: Introduce `Custom` variants for every style in the built-in `Theme` --- style/src/theme.rs | 642 +++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 453 insertions(+), 189 deletions(-) (limited to 'style/src/theme.rs') diff --git a/style/src/theme.rs b/style/src/theme.rs index a253e990..a5a78ab1 100644 --- a/style/src/theme.rs +++ b/style/src/theme.rs @@ -19,7 +19,9 @@ use crate::text; use crate::text_input; use crate::toggler; -use iced_core::{Background, Color}; +use iced_core::{Background, Color, Vector}; + +use std::rc::Rc; #[derive(Debug, Clone, PartialEq)] pub enum Theme { @@ -71,10 +73,9 @@ impl Custom { } } -#[derive(Debug, Clone, Copy)] pub enum Application { Default, - Custom(fn(Theme) -> application::Appearance), + Custom(Box>), } impl Default for Application { @@ -86,7 +87,7 @@ impl Default for Application { impl application::StyleSheet for Theme { type Style = Application; - fn appearance(&self, style: Self::Style) -> application::Appearance { + fn appearance(&self, style: &Self::Style) -> application::Appearance { let palette = self.extended_palette(); match style { @@ -94,21 +95,35 @@ impl application::StyleSheet for Theme { background_color: palette.background.base.color, text_color: palette.background.base.text, }, - Application::Custom(f) => f(self.clone()), + Application::Custom(custom) => custom.appearance(self), } } } +impl application::StyleSheet for fn(&Theme) -> application::Appearance { + type Style = Theme; + + fn appearance(&self, style: &Self::Style) -> application::Appearance { + (self)(style) + } +} + +impl From application::Appearance> for Application { + fn from(f: fn(&Theme) -> application::Appearance) -> Self { + Self::Custom(Box::new(f)) + } +} + /* * Button */ -#[derive(Debug, Clone, Copy, PartialEq, Eq)] pub enum Button { Primary, Secondary, Positive, Destructive, Text, + Custom(Box>), } impl Default for Button { @@ -120,7 +135,7 @@ impl Default for Button { impl button::StyleSheet for Theme { type Style = Button; - fn active(&self, style: Self::Style) -> button::Appearance { + fn active(&self, style: &Self::Style) -> button::Appearance { let palette = self.extended_palette(); let appearance = button::Appearance { @@ -143,19 +158,25 @@ impl button::StyleSheet for Theme { text_color: palette.background.base.text, ..appearance }, + Button::Custom(custom) => custom.active(self), } } - fn hovered(&self, style: Self::Style) -> button::Appearance { - let active = self.active(style); + fn hovered(&self, style: &Self::Style) -> button::Appearance { let palette = self.extended_palette(); + if let Button::Custom(custom) = style { + return custom.hovered(self); + } + + let active = self.active(style); + let background = match style { Button::Primary => Some(palette.primary.base.color), Button::Secondary => Some(palette.background.strong.color), Button::Positive => Some(palette.success.strong.color), Button::Destructive => Some(palette.danger.strong.color), - Button::Text => None, + Button::Text | Button::Custom(_) => None, }; button::Appearance { @@ -163,17 +184,51 @@ impl button::StyleSheet for Theme { ..active } } + + fn pressed(&self, style: &Self::Style) -> button::Appearance { + if let Button::Custom(custom) = style { + return custom.pressed(self); + } + + button::Appearance { + shadow_offset: Vector::default(), + ..self.active(style) + } + } + + fn disabled(&self, style: &Self::Style) -> button::Appearance { + if let Button::Custom(custom) = style { + return custom.disabled(self); + } + + let active = self.active(style); + + button::Appearance { + shadow_offset: Vector::default(), + background: active.background.map(|background| match background { + Background::Color(color) => Background::Color(Color { + a: color.a * 0.5, + ..color + }), + }), + text_color: Color { + a: active.text_color.a * 0.5, + ..active.text_color + }, + ..active + } + } } /* * Checkbox */ -#[derive(Debug, Clone, Copy, PartialEq, Eq)] pub enum Checkbox { Primary, Secondary, Success, Danger, + Custom(Box>), } impl Default for Checkbox { @@ -187,7 +242,7 @@ impl checkbox::StyleSheet for Theme { fn active( &self, - style: Self::Style, + style: &Self::Style, is_checked: bool, ) -> checkbox::Appearance { let palette = self.extended_palette(); @@ -217,12 +272,13 @@ impl checkbox::StyleSheet for Theme { palette.danger.base, is_checked, ), + Checkbox::Custom(custom) => custom.active(self, is_checked), } } fn hovered( &self, - style: Self::Style, + style: &Self::Style, is_checked: bool, ) -> checkbox::Appearance { let palette = self.extended_palette(); @@ -252,6 +308,7 @@ impl checkbox::StyleSheet for Theme { palette.danger.base, is_checked, ), + Checkbox::Custom(custom) => custom.hovered(self, is_checked), } } } @@ -279,11 +336,10 @@ fn checkbox_appearance( /* * Container */ -#[derive(Clone, Copy)] pub enum Container { Transparent, Box, - Custom(fn(&Theme) -> container::Appearance), + Custom(Box>), } impl Default for Container { @@ -294,14 +350,14 @@ impl Default for Container { impl From container::Appearance> for Container { fn from(f: fn(&Theme) -> container::Appearance) -> Self { - Self::Custom(f) + Self::Custom(Box::new(f)) } } impl container::StyleSheet for Theme { type Style = Container; - fn appearance(&self, style: Self::Style) -> container::Appearance { + fn appearance(&self, style: &Self::Style) -> container::Appearance { match style { Container::Transparent => Default::default(), Container::Box => { @@ -315,63 +371,96 @@ impl container::StyleSheet for Theme { border_color: Color::TRANSPARENT, } } - Container::Custom(f) => f(self), + Container::Custom(custom) => custom.appearance(self), } } } +impl container::StyleSheet for fn(&Theme) -> container::Appearance { + type Style = Theme; + + fn appearance(&self, style: &Self::Style) -> container::Appearance { + (self)(style) + } +} + /* * Slider */ -impl slider::StyleSheet for Theme { - type Style = (); +#[derive(Default)] +pub enum Slider { + #[default] + Default, + Custom(Box>), +} - fn active(&self, _style: Self::Style) -> slider::Appearance { - let palette = self.extended_palette(); +impl slider::StyleSheet for Theme { + type Style = Slider; - let handle = slider::Handle { - shape: slider::HandleShape::Rectangle { - width: 8, - border_radius: 4.0, - }, - color: Color::WHITE, - border_color: Color::WHITE, - border_width: 1.0, - }; + fn active(&self, style: &Self::Style) -> slider::Appearance { + match style { + Slider::Default => { + let palette = self.extended_palette(); - slider::Appearance { - rail_colors: (palette.primary.base.color, Color::TRANSPARENT), - handle: slider::Handle { - color: palette.background.base.color, - border_color: palette.primary.base.color, - ..handle - }, + let handle = slider::Handle { + shape: slider::HandleShape::Rectangle { + width: 8, + border_radius: 4.0, + }, + color: Color::WHITE, + border_color: Color::WHITE, + border_width: 1.0, + }; + + slider::Appearance { + rail_colors: ( + palette.primary.base.color, + Color::TRANSPARENT, + ), + handle: slider::Handle { + color: palette.background.base.color, + border_color: palette.primary.base.color, + ..handle + }, + } + } + Slider::Custom(custom) => custom.active(self), } } - fn hovered(&self, style: Self::Style) -> slider::Appearance { - let active = self.active(style); - let palette = self.extended_palette(); + fn hovered(&self, style: &Self::Style) -> slider::Appearance { + match style { + Slider::Default => { + let active = self.active(style); + let palette = self.extended_palette(); - slider::Appearance { - handle: slider::Handle { - color: palette.primary.weak.color, - ..active.handle - }, - ..active + slider::Appearance { + handle: slider::Handle { + color: palette.primary.weak.color, + ..active.handle + }, + ..active + } + } + Slider::Custom(custom) => custom.hovered(self), } } - fn dragging(&self, style: Self::Style) -> slider::Appearance { - let active = self.active(style); - let palette = self.extended_palette(); + fn dragging(&self, style: &Self::Style) -> slider::Appearance { + match style { + Slider::Default => { + let active = self.active(style); + let palette = self.extended_palette(); - slider::Appearance { - handle: slider::Handle { - color: palette.primary.base.color, - ..active.handle - }, - ..active + slider::Appearance { + handle: slider::Handle { + color: palette.primary.base.color, + ..active.handle + }, + ..active + } + } + Slider::Custom(custom) => custom.dragging(self), } } } @@ -379,20 +468,41 @@ impl slider::StyleSheet for Theme { /* * Menu */ +#[derive(Clone, Default)] +pub enum Menu { + #[default] + Default, + Custom(Rc>), +} + impl menu::StyleSheet for Theme { - type Style = (); + type Style = Menu; - fn appearance(&self, _style: Self::Style) -> menu::Appearance { - let palette = self.extended_palette(); + fn appearance(&self, style: &Self::Style) -> menu::Appearance { + match style { + Menu::Default => { + let palette = self.extended_palette(); - menu::Appearance { - text_color: palette.background.weak.text, - background: palette.background.weak.color.into(), - border_width: 1.0, - border_radius: 0.0, - border_color: palette.background.strong.color, - selected_text_color: palette.primary.strong.text, - selected_background: palette.primary.strong.color.into(), + menu::Appearance { + text_color: palette.background.weak.text, + background: palette.background.weak.color.into(), + border_width: 1.0, + border_radius: 0.0, + border_color: palette.background.strong.color, + selected_text_color: palette.primary.strong.text, + selected_background: palette.primary.strong.color.into(), + } + } + Menu::Custom(custom) => custom.appearance(self), + } + } +} + +impl From for Menu { + fn from(pick_list: PickList) -> Self { + match pick_list { + PickList::Default => Self::Default, + PickList::Custom(_, menu) => Self::Custom(menu), } } } @@ -400,34 +510,54 @@ impl menu::StyleSheet for Theme { /* * Pick List */ +#[derive(Clone, Default)] +pub enum PickList { + #[default] + Default, + Custom( + Rc>, + Rc>, + ), +} + impl pick_list::StyleSheet for Theme { - type Style = (); + type Style = PickList; - fn active(&self, _style: ()) -> pick_list::Appearance { - let palette = self.extended_palette(); + fn active(&self, style: &Self::Style) -> pick_list::Appearance { + match style { + PickList::Default => { + let palette = self.extended_palette(); - pick_list::Appearance { - text_color: palette.background.weak.text, - background: palette.background.weak.color.into(), - placeholder_color: palette.background.strong.color, - border_radius: 2.0, - border_width: 1.0, - border_color: palette.background.strong.color, - icon_size: 0.7, + pick_list::Appearance { + text_color: palette.background.weak.text, + background: palette.background.weak.color.into(), + placeholder_color: palette.background.strong.color, + border_radius: 2.0, + border_width: 1.0, + border_color: palette.background.strong.color, + icon_size: 0.7, + } + } + PickList::Custom(custom, _) => custom.active(self), } } - fn hovered(&self, _style: ()) -> pick_list::Appearance { - let palette = self.extended_palette(); + fn hovered(&self, style: &Self::Style) -> pick_list::Appearance { + match style { + PickList::Default => { + let palette = self.extended_palette(); - pick_list::Appearance { - text_color: palette.background.weak.text, - background: palette.background.weak.color.into(), - placeholder_color: palette.background.strong.color, - border_radius: 2.0, - border_width: 1.0, - border_color: palette.primary.strong.color, - icon_size: 0.7, + pick_list::Appearance { + text_color: palette.background.weak.text, + background: palette.background.weak.color.into(), + placeholder_color: palette.background.strong.color, + border_radius: 2.0, + border_width: 1.0, + border_color: palette.primary.strong.color, + icon_size: 0.7, + } + } + PickList::Custom(custom, _) => custom.active(self), } } } @@ -435,37 +565,54 @@ impl pick_list::StyleSheet for Theme { /* * Radio */ +#[derive(Default)] +pub enum Radio { + #[default] + Default, + Custom(Box>), +} + impl radio::StyleSheet for Theme { - type Style = (); + type Style = Radio; fn active( &self, - _style: Self::Style, - _is_selected: bool, + style: &Self::Style, + is_selected: bool, ) -> radio::Appearance { - let palette = self.extended_palette(); + match style { + Radio::Default => { + let palette = self.extended_palette(); - radio::Appearance { - background: Color::TRANSPARENT.into(), - dot_color: palette.primary.strong.color, - border_width: 1.0, - border_color: palette.primary.strong.color, - text_color: None, + radio::Appearance { + background: Color::TRANSPARENT.into(), + dot_color: palette.primary.strong.color, + border_width: 1.0, + border_color: palette.primary.strong.color, + text_color: None, + } + } + Radio::Custom(custom) => custom.active(self, is_selected), } } fn hovered( &self, - style: Self::Style, + style: &Self::Style, is_selected: bool, ) -> radio::Appearance { - let active = self.active(style, is_selected); - let palette = self.extended_palette(); + match style { + Radio::Default => { + let active = self.active(style, is_selected); + let palette = self.extended_palette(); - radio::Appearance { - dot_color: palette.primary.strong.color, - background: palette.primary.weak.color.into(), - ..active + radio::Appearance { + dot_color: palette.primary.strong.color, + background: palette.primary.weak.color.into(), + ..active + } + } + Radio::Custom(custom) => custom.hovered(self, is_selected), } } } @@ -473,49 +620,66 @@ impl radio::StyleSheet for Theme { /* * Toggler */ +#[derive(Default)] +pub enum Toggler { + #[default] + Default, + Custom(Box>), +} + impl toggler::StyleSheet for Theme { - type Style = (); + type Style = Toggler; fn active( &self, - _style: Self::Style, + style: &Self::Style, is_active: bool, ) -> toggler::Appearance { - let palette = self.extended_palette(); + match style { + Toggler::Default => { + let palette = self.extended_palette(); - toggler::Appearance { - background: if is_active { - palette.primary.strong.color - } else { - palette.background.strong.color - }, - background_border: None, - foreground: if is_active { - palette.primary.strong.text - } else { - palette.background.base.color - }, - foreground_border: None, + toggler::Appearance { + background: if is_active { + palette.primary.strong.color + } else { + palette.background.strong.color + }, + background_border: None, + foreground: if is_active { + palette.primary.strong.text + } else { + palette.background.base.color + }, + foreground_border: None, + } + } + Toggler::Custom(custom) => custom.active(self, is_active), } } fn hovered( &self, - style: Self::Style, + style: &Self::Style, is_active: bool, ) -> toggler::Appearance { - let palette = self.extended_palette(); + match style { + Toggler::Default => { + let palette = self.extended_palette(); - toggler::Appearance { - foreground: if is_active { - Color { - a: 0.5, - ..palette.primary.strong.text + toggler::Appearance { + foreground: if is_active { + Color { + a: 0.5, + ..palette.primary.strong.text + } + } else { + palette.background.weak.color + }, + ..self.active(style, is_active) } - } else { - palette.background.weak.color - }, - ..self.active(style, is_active) + } + Toggler::Custom(custom) => custom.hovered(self, is_active), } } } @@ -523,37 +687,53 @@ impl toggler::StyleSheet for Theme { /* * Pane Grid */ +#[derive(Default)] +pub enum PaneGrid { + #[default] + Default, + Custom(Box>), +} + impl pane_grid::StyleSheet for Theme { - type Style = (); + type Style = PaneGrid; - fn picked_split(&self, _style: Self::Style) -> Option { - let palette = self.extended_palette(); + fn picked_split(&self, style: &Self::Style) -> Option { + match style { + PaneGrid::Default => { + let palette = self.extended_palette(); - Some(pane_grid::Line { - color: palette.primary.strong.color, - width: 2.0, - }) + Some(pane_grid::Line { + color: palette.primary.strong.color, + width: 2.0, + }) + } + PaneGrid::Custom(custom) => custom.picked_split(self), + } } - fn hovered_split(&self, _style: Self::Style) -> Option { - let palette = self.extended_palette(); + fn hovered_split(&self, style: &Self::Style) -> Option { + match style { + PaneGrid::Default => { + let palette = self.extended_palette(); - Some(pane_grid::Line { - color: palette.primary.base.color, - width: 2.0, - }) + Some(pane_grid::Line { + color: palette.primary.base.color, + width: 2.0, + }) + } + PaneGrid::Custom(custom) => custom.hovered_split(self), + } } } /* * Progress Bar */ -#[derive(Clone, Copy)] pub enum ProgressBar { Primary, Success, Danger, - Custom(fn(&Theme) -> progress_bar::Appearance), + Custom(Box>), } impl Default for ProgressBar { @@ -562,10 +742,20 @@ impl Default for ProgressBar { } } +impl From progress_bar::Appearance> for ProgressBar { + fn from(f: fn(&Theme) -> progress_bar::Appearance) -> Self { + Self::Custom(Box::new(f)) + } +} + impl progress_bar::StyleSheet for Theme { type Style = ProgressBar; - fn appearance(&self, style: Self::Style) -> progress_bar::Appearance { + fn appearance(&self, style: &Self::Style) -> progress_bar::Appearance { + if let ProgressBar::Custom(custom) = style { + return custom.appearance(self); + } + let palette = self.extended_palette(); let from_palette = |bar: Color| progress_bar::Appearance { @@ -578,18 +768,25 @@ impl progress_bar::StyleSheet for Theme { ProgressBar::Primary => from_palette(palette.primary.base.color), ProgressBar::Success => from_palette(palette.success.base.color), ProgressBar::Danger => from_palette(palette.danger.base.color), - ProgressBar::Custom(f) => f(self), + ProgressBar::Custom(custom) => custom.appearance(self), } } } +impl progress_bar::StyleSheet for fn(&Theme) -> progress_bar::Appearance { + type Style = Theme; + + fn appearance(&self, style: &Self::Style) -> progress_bar::Appearance { + (self)(style) + } +} + /* * Rule */ -#[derive(Clone, Copy)] pub enum Rule { Default, - Custom(fn(&Theme) -> rule::Appearance), + Custom(Box>), } impl Default for Rule { @@ -598,10 +795,16 @@ impl Default for Rule { } } +impl From rule::Appearance> for Rule { + fn from(f: fn(&Theme) -> rule::Appearance) -> Self { + Self::Custom(Box::new(f)) + } +} + impl rule::StyleSheet for Theme { type Style = Rule; - fn style(&self, style: Self::Style) -> rule::Appearance { + fn appearance(&self, style: &Self::Style) -> rule::Appearance { let palette = self.extended_palette(); match style { @@ -611,48 +814,80 @@ impl rule::StyleSheet for Theme { radius: 0.0, fill_mode: rule::FillMode::Full, }, - Rule::Custom(f) => f(self), + Rule::Custom(custom) => custom.appearance(self), } } } +impl rule::StyleSheet for fn(&Theme) -> rule::Appearance { + type Style = Theme; + + fn appearance(&self, style: &Self::Style) -> rule::Appearance { + (self)(style) + } +} + /* * Scrollable */ +#[derive(Default)] +pub enum Scrollable { + #[default] + Default, + Custom(Box>), +} + impl scrollable::StyleSheet for Theme { - type Style = (); + type Style = Scrollable; - fn active(&self, _style: Self::Style) -> scrollable::Scrollbar { - let palette = self.extended_palette(); + fn active(&self, style: &Self::Style) -> scrollable::Scrollbar { + match style { + Scrollable::Default => { + let palette = self.extended_palette(); - scrollable::Scrollbar { - background: palette.background.weak.color.into(), - border_radius: 2.0, - border_width: 0.0, - border_color: Color::TRANSPARENT, - scroller: scrollable::Scroller { - color: palette.background.strong.color, - border_radius: 2.0, - border_width: 0.0, - border_color: Color::TRANSPARENT, - }, + scrollable::Scrollbar { + background: palette.background.weak.color.into(), + border_radius: 2.0, + border_width: 0.0, + border_color: Color::TRANSPARENT, + scroller: scrollable::Scroller { + color: palette.background.strong.color, + border_radius: 2.0, + border_width: 0.0, + border_color: Color::TRANSPARENT, + }, + } + } + Scrollable::Custom(custom) => custom.active(self), } } - fn hovered(&self, _style: Self::Style) -> scrollable::Scrollbar { - let palette = self.extended_palette(); + fn hovered(&self, style: &Self::Style) -> scrollable::Scrollbar { + match style { + Scrollable::Default => { + let palette = self.extended_palette(); - scrollable::Scrollbar { - background: palette.background.weak.color.into(), - border_radius: 2.0, - border_width: 0.0, - border_color: Color::TRANSPARENT, - scroller: scrollable::Scroller { - color: palette.primary.strong.color, - border_radius: 2.0, - border_width: 0.0, - border_color: Color::TRANSPARENT, - }, + scrollable::Scrollbar { + background: palette.background.weak.color.into(), + border_radius: 2.0, + border_width: 0.0, + border_color: Color::TRANSPARENT, + scroller: scrollable::Scroller { + color: palette.primary.strong.color, + border_radius: 2.0, + border_width: 0.0, + border_color: Color::TRANSPARENT, + }, + } + } + Scrollable::Custom(custom) => custom.hovered(self), + } + } + + fn dragging(&self, style: &Self::Style) -> scrollable::Scrollbar { + match style { + Scrollable::Default => self.hovered(style), + Scrollable::Custom(custom) => custom.dragging(self), } } } @@ -664,7 +899,6 @@ impl scrollable::StyleSheet for Theme { pub enum Text { Default, Color(Color), - Custom(fn(&Theme) -> text::Appearance), } impl Default for Text { @@ -686,7 +920,6 @@ impl text::StyleSheet for Theme { match style { Text::Default => Default::default(), Text::Color(c) => text::Appearance { color: Some(c) }, - Text::Custom(f) => f(self), } } } @@ -694,10 +927,21 @@ impl text::StyleSheet for Theme { /* * Text Input */ +#[derive(Default)] +pub enum TextInput { + #[default] + Default, + Custom(Box>), +} + impl text_input::StyleSheet for Theme { - type Style = (); + type Style = TextInput; + + fn active(&self, style: &Self::Style) -> text_input::Appearance { + if let TextInput::Custom(custom) = style { + return custom.active(self); + } - fn active(&self, _style: Self::Style) -> text_input::Appearance { let palette = self.extended_palette(); text_input::Appearance { @@ -708,7 +952,11 @@ impl text_input::StyleSheet for Theme { } } - fn hovered(&self, _style: Self::Style) -> text_input::Appearance { + fn hovered(&self, style: &Self::Style) -> text_input::Appearance { + if let TextInput::Custom(custom) = style { + return custom.hovered(self); + } + let palette = self.extended_palette(); text_input::Appearance { @@ -719,7 +967,11 @@ impl text_input::StyleSheet for Theme { } } - fn focused(&self, _style: Self::Style) -> text_input::Appearance { + fn focused(&self, style: &Self::Style) -> text_input::Appearance { + if let TextInput::Custom(custom) = style { + return custom.focused(self); + } + let palette = self.extended_palette(); text_input::Appearance { @@ -730,19 +982,31 @@ impl text_input::StyleSheet for Theme { } } - fn placeholder_color(&self, _style: Self::Style) -> Color { + fn placeholder_color(&self, style: &Self::Style) -> Color { + if let TextInput::Custom(custom) = style { + return custom.placeholder_color(self); + } + let palette = self.extended_palette(); palette.background.strong.color } - fn value_color(&self, _style: Self::Style) -> Color { + fn value_color(&self, style: &Self::Style) -> Color { + if let TextInput::Custom(custom) = style { + return custom.value_color(self); + } + let palette = self.extended_palette(); palette.background.base.text } - fn selection_color(&self, _style: Self::Style) -> Color { + fn selection_color(&self, style: &Self::Style) -> Color { + if let TextInput::Custom(custom) = style { + return custom.selection_color(self); + } + let palette = self.extended_palette(); palette.primary.weak.color -- cgit From 84a1edecea8ab7d7b8aa76b77f2f44042602dd67 Mon Sep 17 00:00:00 2001 From: Héctor Ramón Jiménez Date: Wed, 9 Nov 2022 04:07:42 +0100 Subject: Use `derive(Default)` for `theme` types --- style/src/theme.rs | 66 +++++++++++++----------------------------------------- 1 file changed, 16 insertions(+), 50 deletions(-) (limited to 'style/src/theme.rs') diff --git a/style/src/theme.rs b/style/src/theme.rs index a5a78ab1..ca2d1904 100644 --- a/style/src/theme.rs +++ b/style/src/theme.rs @@ -23,8 +23,9 @@ use iced_core::{Background, Color, Vector}; use std::rc::Rc; -#[derive(Debug, Clone, PartialEq)] +#[derive(Debug, Clone, PartialEq, Default)] pub enum Theme { + #[default] Light, Dark, Custom(Box), @@ -52,12 +53,6 @@ impl Theme { } } -impl Default for Theme { - fn default() -> Self { - Self::Light - } -} - #[derive(Debug, Clone, Copy, PartialEq)] pub struct Custom { palette: Palette, @@ -73,17 +68,13 @@ impl Custom { } } +#[derive(Default)] pub enum Application { + #[default] Default, Custom(Box>), } -impl Default for Application { - fn default() -> Self { - Self::Default - } -} - impl application::StyleSheet for Theme { type Style = Application; @@ -117,7 +108,9 @@ impl From application::Appearance> for Application { /* * Button */ +#[derive(Default)] pub enum Button { + #[default] Primary, Secondary, Positive, @@ -126,12 +119,6 @@ pub enum Button { Custom(Box>), } -impl Default for Button { - fn default() -> Self { - Self::Primary - } -} - impl button::StyleSheet for Theme { type Style = Button; @@ -223,7 +210,9 @@ impl button::StyleSheet for Theme { /* * Checkbox */ +#[derive(Default)] pub enum Checkbox { + #[default] Primary, Secondary, Success, @@ -231,12 +220,6 @@ pub enum Checkbox { Custom(Box>), } -impl Default for Checkbox { - fn default() -> Self { - Self::Primary - } -} - impl checkbox::StyleSheet for Theme { type Style = Checkbox; @@ -336,18 +319,14 @@ fn checkbox_appearance( /* * Container */ +#[derive(Default)] pub enum Container { + #[default] Transparent, Box, Custom(Box>), } -impl Default for Container { - fn default() -> Self { - Self::Transparent - } -} - impl From container::Appearance> for Container { fn from(f: fn(&Theme) -> container::Appearance) -> Self { Self::Custom(Box::new(f)) @@ -729,19 +708,15 @@ impl pane_grid::StyleSheet for Theme { /* * Progress Bar */ +#[derive(Default)] pub enum ProgressBar { + #[default] Primary, Success, Danger, Custom(Box>), } -impl Default for ProgressBar { - fn default() -> Self { - Self::Primary - } -} - impl From progress_bar::Appearance> for ProgressBar { fn from(f: fn(&Theme) -> progress_bar::Appearance) -> Self { Self::Custom(Box::new(f)) @@ -784,17 +759,13 @@ impl progress_bar::StyleSheet for fn(&Theme) -> progress_bar::Appearance { /* * Rule */ +#[derive(Default)] pub enum Rule { + #[default] Default, Custom(Box>), } -impl Default for Rule { - fn default() -> Self { - Self::Default - } -} - impl From rule::Appearance> for Rule { fn from(f: fn(&Theme) -> rule::Appearance) -> Self { Self::Custom(Box::new(f)) @@ -895,18 +866,13 @@ impl scrollable::StyleSheet for Theme { /* * Text */ -#[derive(Clone, Copy)] +#[derive(Clone, Copy, Default)] pub enum Text { + #[default] Default, Color(Color), } -impl Default for Text { - fn default() -> Self { - Self::Default - } -} - impl From for Text { fn from(color: Color) -> Self { Text::Color(color) -- cgit From 4b3d0fb08d5b2e84c1061fa601b71363b6719f59 Mon Sep 17 00:00:00 2001 From: Héctor Ramón Jiménez Date: Thu, 10 Nov 2022 01:10:28 +0100 Subject: Write documentation for `iced_style` --- style/src/theme.rs | 109 ++++++++++++++++++++++++++++++++--------------------- 1 file changed, 67 insertions(+), 42 deletions(-) (limited to 'style/src/theme.rs') diff --git a/style/src/theme.rs b/style/src/theme.rs index ca2d1904..d7ebb827 100644 --- a/style/src/theme.rs +++ b/style/src/theme.rs @@ -1,3 +1,4 @@ +//! Use the built-in theme and styles. pub mod palette; use self::palette::Extended; @@ -23,19 +24,25 @@ use iced_core::{Background, Color, Vector}; use std::rc::Rc; +/// A built-in theme. #[derive(Debug, Clone, PartialEq, Default)] pub enum Theme { + /// The built-in light variant. #[default] Light, + /// The built-in dark variant. Dark, + /// A [`Theme`] that uses a [`Custom`] palette. Custom(Box), } impl Theme { + /// Creates a new custom [`Theme`] from the given [`Palette`]. pub fn custom(palette: Palette) -> Self { Self::Custom(Box::new(Custom::new(palette))) } + /// Returns the [`Palette`] of the [`Theme`]. pub fn palette(&self) -> Palette { match self { Self::Light => Palette::LIGHT, @@ -44,6 +51,7 @@ impl Theme { } } + /// Returns the [`palette::Extended`] of the [`Theme`]. pub fn extended_palette(&self) -> &palette::Extended { match self { Self::Light => &palette::EXTENDED_LIGHT, @@ -53,6 +61,7 @@ impl Theme { } } +/// A [`Theme`] with a customized [`Palette`]. #[derive(Debug, Clone, Copy, PartialEq)] pub struct Custom { palette: Palette, @@ -60,6 +69,7 @@ pub struct Custom { } impl Custom { + /// Creates a [`Custom`] theme from the given [`Palette`]. pub fn new(palette: Palette) -> Self { Self { palette, @@ -68,10 +78,13 @@ impl Custom { } } +/// The style of an application. #[derive(Default)] pub enum Application { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } @@ -105,17 +118,23 @@ impl From application::Appearance> for Application { } } -/* - * Button - */ +/// The style of a button. #[derive(Default)] pub enum Button { + /// The primary style. #[default] Primary, + /// The secondary style. Secondary, + /// The positive style. Positive, + /// The destructive style. Destructive, + /// The text style. + /// + /// Useful for links! Text, + /// A custom style. Custom(Box>), } @@ -207,16 +226,19 @@ impl button::StyleSheet for Theme { } } -/* - * Checkbox - */ +/// The style of a checkbox. #[derive(Default)] pub enum Checkbox { + /// The primary style. #[default] Primary, + /// The secondary style. Secondary, + /// The success style. Success, + /// The danger style. Danger, + /// A custom style. Custom(Box>), } @@ -316,14 +338,15 @@ fn checkbox_appearance( } } -/* - * Container - */ +/// The style of a container. #[derive(Default)] pub enum Container { + /// No style. #[default] Transparent, + /// A simple box. Box, + /// A custom style. Custom(Box>), } @@ -363,13 +386,13 @@ impl container::StyleSheet for fn(&Theme) -> container::Appearance { } } -/* - * Slider - */ +/// The style of a slider. #[derive(Default)] pub enum Slider { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } @@ -444,13 +467,13 @@ impl slider::StyleSheet for Theme { } } -/* - * Menu - */ +/// The style of a menu. #[derive(Clone, Default)] pub enum Menu { + /// The default style. #[default] Default, + /// A custom style. Custom(Rc>), } @@ -486,13 +509,13 @@ impl From for Menu { } } -/* - * Pick List - */ +/// The style of a pick list. #[derive(Clone, Default)] pub enum PickList { + /// The default style. #[default] Default, + /// A custom style. Custom( Rc>, Rc>, @@ -541,13 +564,13 @@ impl pick_list::StyleSheet for Theme { } } -/* - * Radio - */ +/// The style of a radio button. #[derive(Default)] pub enum Radio { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } @@ -596,13 +619,13 @@ impl radio::StyleSheet for Theme { } } -/* - * Toggler - */ +/// The style of a toggler. #[derive(Default)] pub enum Toggler { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } @@ -663,13 +686,13 @@ impl toggler::StyleSheet for Theme { } } -/* - * Pane Grid - */ +/// The style of a pane grid. #[derive(Default)] pub enum PaneGrid { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } @@ -705,15 +728,17 @@ impl pane_grid::StyleSheet for Theme { } } -/* - * Progress Bar - */ +/// The style of a progress bar. #[derive(Default)] pub enum ProgressBar { + /// The primary style. #[default] Primary, + /// The success style. Success, + /// The danger style. Danger, + /// A custom style. Custom(Box>), } @@ -756,13 +781,13 @@ impl progress_bar::StyleSheet for fn(&Theme) -> progress_bar::Appearance { } } -/* - * Rule - */ +/// The style of a rule. #[derive(Default)] pub enum Rule { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } @@ -798,13 +823,13 @@ impl rule::StyleSheet for fn(&Theme) -> rule::Appearance { } } -/* - * Scrollable - */ +/// The style of a scrollable. #[derive(Default)] pub enum Scrollable { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } @@ -863,13 +888,13 @@ impl scrollable::StyleSheet for Theme { } } -/* - * Text - */ +/// The style of text. #[derive(Clone, Copy, Default)] pub enum Text { + /// The default style. #[default] Default, + /// Colored text. Color(Color), } @@ -890,13 +915,13 @@ impl text::StyleSheet for Theme { } } -/* - * Text Input - */ +/// The style of a text input. #[derive(Default)] pub enum TextInput { + /// The default style. #[default] Default, + /// A custom style. Custom(Box>), } -- cgit