🚧 General components review

pagetop/src/base/component/button.rs

@@ -0,0 +1,214 @@
+use crate::prelude::*;
+
+#[derive(Default)]
+pub enum ButtonType {
+    #[default]
+    Link,
+    Primary,
+}
+
+#[rustfmt::skip]
+impl ToString for ButtonType {
+    fn to_string(&self) -> String {
+        String::from(match self {
+            ButtonType::Link    => "pt-button__link",
+            ButtonType::Primary => "pt-button__primary",
+        })
+    }
+}
+
+#[derive(Default)]
+pub enum ButtonTarget {
+    #[default]
+    Default,
+    Blank,
+    Parent,
+    Top,
+    Context(String),
+}
+
+type ButtonIcon = ArcTypedComponent<Icon>;
+
+#[rustfmt::skip]
+#[derive(Default)]
+pub struct Button {
+    id         : OptionId,
+    weight     : Weight,
+    renderable : Renderable,
+    classes    : OptionClasses,
+    button_type: ButtonType,
+    font_size  : FontSize,
+    href       : OptionString,
+    html       : OptionTranslated,
+    left_icon  : ButtonIcon,
+    right_icon : ButtonIcon,
+    target     : ButtonTarget,
+}
+
+impl_handle!(COMPONENT_BASE_BUTTON for Button);
+
+impl ComponentTrait for Button {
+    fn new() -> Self {
+        Button::default()
+    }
+
+    fn id(&self) -> Option<String> {
+        self.id.get()
+    }
+
+    fn weight(&self) -> Weight {
+        self.weight
+    }
+
+    fn is_renderable(&self, cx: &Context) -> bool {
+        (self.renderable.check)(cx)
+    }
+
+    fn setup_before_prepare(&mut self, _cx: &mut Context) {
+        self.classes.alter_value(
+            ClassesOp::AddFirst,
+            [self.button_type.to_string(), self.font_size.to_string()].join(" "),
+        );
+    }
+
+    #[rustfmt::skip]
+    fn prepare_component(&self, cx: &mut Context) -> PrepareMarkup {
+        let target = match &self.target() {
+            ButtonTarget::Blank  => Some("_blank"),
+            ButtonTarget::Parent => Some("_parent"),
+            ButtonTarget::Top    => Some("_top"),
+            ButtonTarget::Context(name) => Some(name.as_str()),
+            _ => None,
+        };
+        PrepareMarkup::With(html! {
+            a
+                id=[self.id()]
+                class=[self.classes().get()]
+                href=[self.href().get()]
+                target=[target]
+            {
+                (self.left_icon().render(cx))
+                " " span { (self.html().escaped(cx.langid()).unwrap_or_default()) } " "
+                (self.right_icon().render(cx))
+            }
+        })
+    }
+}
+
+impl Button {
+    pub fn link(href: impl Into<String>, html: L10n) -> Self {
+        Button::default()
+            .with_type(ButtonType::Link)
+            .with_href(href)
+            .with_html(html)
+    }
+
+    pub fn primary(href: impl Into<String>, html: L10n) -> Self {
+        Button::default()
+            .with_type(ButtonType::Primary)
+            .with_href(href)
+            .with_html(html)
+    }
+
+    // Button BUILDER.
+
+    #[fn_builder]
+    pub fn alter_id(&mut self, id: impl Into<String>) -> &mut Self {
+        self.id.alter_value(id);
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_weight(&mut self, value: Weight) -> &mut Self {
+        self.weight = value;
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_renderable(&mut self, check: FnIsRenderable) -> &mut Self {
+        self.renderable.check = check;
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_classes(&mut self, op: ClassesOp, classes: impl Into<String>) -> &mut Self {
+        self.classes.alter_value(op, classes);
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_type(&mut self, button_type: ButtonType) -> &mut Self {
+        self.button_type = button_type;
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_font_size(&mut self, font_size: FontSize) -> &mut Self {
+        self.font_size = font_size;
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_href(&mut self, href: impl Into<String>) -> &mut Self {
+        self.href.alter_value(href);
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_html(&mut self, html: L10n) -> &mut Self {
+        self.html.alter_value(html);
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_left_icon(&mut self, icon: Icon) -> &mut Self {
+        self.left_icon.set(icon);
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_right_icon(&mut self, icon: Icon) -> &mut Self {
+        self.right_icon.set(icon);
+        self
+    }
+
+    #[fn_builder]
+    pub fn alter_target(&mut self, target: ButtonTarget) -> &mut Self {
+        self.target = target;
+        self
+    }
+
+    // Button GETTERS.
+
+    pub fn classes(&self) -> &OptionClasses {
+        &self.classes
+    }
+
+    pub fn button_type(&self) -> &ButtonType {
+        &self.button_type
+    }
+
+    pub fn font_size(&self) -> &FontSize {
+        &self.font_size
+    }
+
+    pub fn href(&self) -> &OptionString {
+        &self.href
+    }
+
+    pub fn html(&self) -> &OptionTranslated {
+        &self.html
+    }
+
+    pub fn left_icon(&self) -> &ButtonIcon {
+        &self.left_icon
+    }
+
+    pub fn right_icon(&self) -> &ButtonIcon {
+        &self.right_icon
+    }
+
+    pub fn target(&self) -> &ButtonTarget {
+        &self.target
+    }
+}