thaw 0.4.8

An easy to use leptos component library
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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

use leptos::{
    ev::{self, on},
    html,
    leptos_dom::helpers::TimeoutHandle,
    prelude::*,
    tachys::html::class::class as tachys_class,
};
use std::time::Duration;
use thaw_components::{Follower, FollowerPlacement};
use thaw_utils::{class_list, mount_style};

#[component]
pub fn Tooltip<T>(
    /// The text of the tooltip.
    #[prop(optional, into)]
    content: Option<Signal<String>>,
    /// Configure the position of the tooltip.
    #[prop(optional)]
    position: TooltipPosition,
    /// The tooltip's visual appearance.
    #[prop(optional, into)]
    appearance: Signal<TooltipAppearance>,
    children: TypedChildren<T>,
) -> impl IntoView
where
    T: AddAnyAttr + IntoView + Send + 'static,
{
    mount_style("tooltip", include_str!("./tooltip.css"));

    let is_show_content = RwSignal::new(false);
    let content_handle = StoredValue::new(None::<TimeoutHandle>);

    let on_mouse_enter = move |_| {
        content_handle.update_value(|handle| {
            if let Some(handle) = handle.take() {
                handle.clear();
            }
        });
        is_show_content.set(true);
    };
    let on_mouse_leave = move |_| {
        content_handle.update_value(|handle| {
            if let Some(handle) = handle.take() {
                handle.clear();
            }
            *handle = set_timeout_with_handle(
                move || {
                    is_show_content.set(false);
                },
                Duration::from_millis(100),
            )
            .ok();
        });
    };

    let arrow_ref = NodeRef::<html::Div>::new();
    let edge_length = 1.414 * 8.0;
    let arrow_style = format!(
        "--thaw-positioning-arrow-height: {}px; --thaw-positioning-arrow-offset: {}px;",
        edge_length,
        (edge_length / 2.0) * -1.0
    );

    Owner::on_cleanup(move || {
        content_handle.update_value(|handle| {
            if let Some(handle) = handle.take() {
                handle.clear();
            }
        });
    });

    view! {
        <crate::_binder::Binder>
            {children
                .into_inner()()
                .into_inner()
                .add_any_attr(tachys_class(("thaw-tooltip", true)))
                .add_any_attr(on(ev::mouseenter, on_mouse_enter))
                .add_any_attr(on(ev::mouseleave, on_mouse_leave))}
            <Follower slot show=is_show_content placement=position arrow=(edge_length / 2.0 + 2.0, arrow_ref)>
                <div
                    class=class_list![
                        "thaw-tooltip-content",
                         move || format!("thaw-tooltip-content--{}", appearance.get().as_str())
                    ]
                    role="tooltip"
                    on:mouseenter=on_mouse_enter
                    on:mouseleave=on_mouse_leave
                >
                    {move || { content.as_ref().map(|c| c.get()).unwrap_or_default() }}
                    <div class="thaw-tooltip-content__angle" style=arrow_style node_ref=arrow_ref></div>
                </div>
            </Follower>
        </crate::_binder::Binder>
    }
}

#[derive(Clone, Default)]
pub enum TooltipAppearance {
    #[default]
    Normal,
    Inverted,
}

impl TooltipAppearance {
    pub fn as_str(&self) -> &'static str {
        match self {
            Self::Normal => "normal",
            Self::Inverted => "inverted",
        }
    }
}

#[derive(Default)]
pub enum TooltipPosition {
    #[default]
    Top,
    Bottom,
    Left,
    Right,
    TopStart,
    TopEnd,
    LeftStart,
    LeftEnd,
    RightStart,
    RightEnd,
    BottomStart,
    BottomEnd,
}

impl From<TooltipPosition> for FollowerPlacement {
    fn from(value: TooltipPosition) -> Self {
        match value {
            TooltipPosition::Top => Self::Top,
            TooltipPosition::Bottom => Self::Bottom,
            TooltipPosition::Left => Self::Left,
            TooltipPosition::Right => Self::Right,
            TooltipPosition::TopStart => Self::TopStart,
            TooltipPosition::TopEnd => Self::TopEnd,
            TooltipPosition::LeftStart => Self::LeftStart,
            TooltipPosition::LeftEnd => Self::LeftEnd,
            TooltipPosition::RightStart => Self::RightStart,
            TooltipPosition::RightEnd => Self::RightEnd,
            TooltipPosition::BottomStart => Self::BottomStart,
            TooltipPosition::BottomEnd => Self::BottomEnd,
        }
    }
}