ev_lib 0.17.1

EV-invest shared Rust libraries, one per feature
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

use dioxus::prelude::*;

use crate::{
	cn,
	uikit::{
		TOOLTIP_CONTENT,
		primitives::{Controllable, use_controllable},
	},
};

/// Optional, no-op wrapper kept for API parity with the TS `TooltipProvider`.
#[component]
pub fn TooltipProvider(children: Element) -> Element {
	rsx! {
		{children}
	}
}

#[component]
pub fn Tooltip(open: Option<bool>, #[props(default)] default_open: bool, on_open_change: Option<EventHandler<bool>>, children: Element) -> Element {
	let state = use_controllable(open, default_open, on_open_change);
	use_context_provider(|| TooltipCtx { open: state });
	// dep-light: inline positioning + backdrop; no portal/floating — see README Limitations
	rsx! {
		div {
			class: "relative inline-block",
			onkeydown: move |e| {
				if e.key() == Key::Escape {
					state.set(false);
				}
			},
			{children}
		}
	}
}

#[component]
pub fn TooltipTrigger(#[props(default)] class: String, children: Element) -> Element {
	let ctx = use_context::<TooltipCtx>();
	rsx! {
		button {
			r#type: "button",
			class,
			"data-slot": "tooltip-trigger",
			onmouseenter: move |_| ctx.open.set(true),
			onmouseleave: move |_| ctx.open.set(false),
			onfocusin: move |_| ctx.open.set(true),
			onfocusout: move |_| ctx.open.set(false),
			{children}
		}
	}
}

#[component]
pub fn TooltipContent(#[props(default)] class: String, children: Element) -> Element {
	let ctx = use_context::<TooltipCtx>();
	if !ctx.open.get() {
		return rsx! {};
	}
	let cls = cn!(TOOLTIP_CONTENT, "absolute bottom-full left-1/2 -translate-x-1/2 mb-1", class);
	rsx! {
		div {
			class: cls,
			role: "tooltip",
			"data-slot": "tooltip-content",
			"data-state": "open",
			"data-side": "top",
			{children}
		}
	}
}

#[derive(Clone, Copy)]
struct TooltipCtx {
	open: Controllable<bool>,
}

#[cfg(test)]
mod tests {
	use super::*;
	use crate::uikit::test_util::render;

	#[test]
	fn closed_by_default_hides_content() {
		fn app() -> Element {
			rsx! {
				Tooltip {
					TooltipTrigger { "hover" }
					TooltipContent { "hint-body" }
				}
			}
		}
		let html = render(app);
		assert!(html.contains("data-slot=\"tooltip-trigger\""), "{html}");
		assert!(!html.contains("hint-body"), "content hidden while closed: {html}");
	}

	#[test]
	fn default_open_reveals_content() {
		fn app() -> Element {
			rsx! {
				Tooltip { default_open: true,
					TooltipTrigger { "hover" }
					TooltipContent { "hint-body" }
				}
			}
		}
		let html = render(app);
		assert!(html.contains("data-slot=\"tooltip-content\""), "{html}");
		assert!(html.contains("hint-body"), "{html}");
		assert!(html.contains("data-state=\"open\""), "{html}");
		assert!(html.contains("data-side=\"top\""), "{html}");
		assert!(html.contains("role=\"tooltip\""), "{html}");
	}
}