zino-dioxus 0.3.3

Dioxus components for zino.
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! Icon fonts or SVG icon shapes.

use crate::{class::Class, format_class};
use dioxus::prelude::*;
use dioxus_free_icons::IconShape;

/// A container for any type of icon fonts.
pub fn Icon<'a>(cx: Scope<'a, IconProps<'a>>) -> Element {
    let class = format_class!(cx, "icon");
    if let Some(icon) = cx.props.icon_class.as_ref() {
        let icon_class = icon.format();
        render! {
            span {
                class: "{class}",
                i {
                    class: "{icon_class}"
                }
            }
        }
    } else {
        render! {
            span {
                class: "{class}",
                &cx.props.children
            }
        }
    }
}

/// The [`Icon`] properties struct for the configuration of the component.
#[derive(Props)]
pub struct IconProps<'a> {
    /// The class attribute for the component.
    #[props(into)]
    pub class: Option<Class<'a>>,
    /// The class to apply to the `<i>` element for a icon font.
    #[props(into)]
    pub icon_class: Option<Class<'a>>,
    /// The children to render within the component.
    children: Element<'a>,
}

/// A container for a SVG icon.
pub fn SvgIcon<'a, T: IconShape + Copy>(cx: Scope<'a, SvgIconProps<'a, T>>) -> Element {
    let class = format_class!(cx, "icon");
    let width = cx.props.width;
    let height = cx.props.height.unwrap_or(width);
    let style = if cx.props.intrinsic {
        format!("width:{width}px;height:{height}px")
    } else {
        String::new()
    };
    render! {
        span {
            class: "{class}",
            style: "{style}",
            dioxus_free_icons::Icon {
                icon: cx.props.shape,
                width: width,
                height: height,
            }
        }
    }
}

/// The [`SvgIcon`] properties struct for the configuration of the component.
#[derive(Props)]
pub struct SvgIconProps<'a, T: IconShape> {
    /// The class attribute for the component.
    #[props(into)]
    pub class: Option<Class<'a>>,
    /// The icon shape to use.
    pub shape: T,
    /// The width of the `<svg>` element. Defaults to 20.
    #[props(default = 20)]
    pub width: u32,
    /// The height of the `<svg>` element.
    #[props(into)]
    pub height: Option<u32>,
    /// A flag to use the instrinsic size for the icon.
    #[props(default = false)]
    pub intrinsic: bool,
}

/// A wrapper for combining an icon with text.
pub fn IconText<'a>(cx: Scope<'a, IconTextProps<'a>>) -> Element {
    let class = format_class!(cx, "icon-text");
    render! {
        span {
            class: "{class}",
            &cx.props.children
        }
    }
}

/// The [`IconText`] properties struct for the configuration of the component.
#[derive(Props)]
pub struct IconTextProps<'a> {
    /// The class attribute for the component.
    #[props(into)]
    pub class: Option<Class<'a>>,
    /// The children to render within the component.
    children: Element<'a>,
}