leptos_form_tool 0.4.1

A declarative way to create forms for leptos.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use super::{
    BuilderCxFn, BuilderFn, ControlRenderData, GetterVanityControlData, VanityControlBuilder,
    VanityControlData,
};
use crate::{form::FormToolData, form_builder::FormBuilder, styles::FormStyle};
use leptos::prelude::{AnyView, Signal};
use std::sync::Arc;

#[derive(Copy, Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Default)]
pub enum HeadingLevel {
    #[default]
    H1,
    H2,
    H3,
    H4,
}

/// Data used for the heading control.
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct HeadingData {
    pub level: HeadingLevel,
}

impl<FD: FormToolData> VanityControlData<FD> for HeadingData {
    fn render_control<FS: FormStyle>(
        fs: &FS,
        _fd: leptos::prelude::RwSignal<FD>,
        control: ControlRenderData<FS, Self>,
        value_getter: Option<Signal<String>>,
    ) -> AnyView {
        fs.heading(control, value_getter)
    }
}
impl<FD: FormToolData> GetterVanityControlData<FD> for HeadingData {}

impl<FD: FormToolData> FormBuilder<FD> {
    /// Builds a heading and adds it to the form.
    pub fn heading(self, builder: impl BuilderFn<VanityControlBuilder<FD, HeadingData>>) -> Self {
        self.new_vanity(builder)
    }

    /// Builds a hehading using the form's context and adds it to the form.
    pub fn heading_cx(
        self,
        builder: impl BuilderCxFn<VanityControlBuilder<FD, HeadingData>, FD::Context>,
    ) -> Self {
        self.new_vanity_cx(builder)
    }
}

impl<FD: FormToolData> VanityControlBuilder<FD, HeadingData> {
    /// Sets the title of this heading.
    pub fn title(mut self, title: impl ToString) -> Self {
        let title = title.to_string();
        self.getter = Some(Arc::new(move |_| title.clone()));
        self
    }

    /// Sets this title to be a `h1`.
    pub fn h1(mut self) -> Self {
        self.data.level = HeadingLevel::H1;
        self
    }

    /// Sets this title to be a `h2`.
    pub fn h2(mut self) -> Self {
        self.data.level = HeadingLevel::H2;
        self
    }

    /// Sets this title to be a `h3`.
    pub fn h3(mut self) -> Self {
        self.data.level = HeadingLevel::H3;
        self
    }

    /// Sets this title to be a `h4`.
    pub fn h4(mut self) -> Self {
        self.data.level = HeadingLevel::H4;
        self
    }
}