euv-ui 0.17.0

Reusable UI component library for the euv framework, providing buttons, cards, modals, inputs, and more.
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

use super::*;

/// One node of the [`euv_sidebar`] navigation tree.
///
/// A node with empty `children` is a leaf link; a node with children is a
/// collapsible group whose `link` (when set) navigates to the group index
/// page without toggling the group.
#[derive(Clone, Copy, CustomDebug, Data, Default, New)]
pub struct EuvSidebarItem {
    /// The display text.
    #[get(type(copy))]
    pub text: &'static str,
    /// The leaf route; groups may link to their index page.
    #[get(type(copy))]
    pub link: Option<&'static str>,
    /// Nested children (non-empty renders a collapsible group).
    #[get(type(copy))]
    pub children: &'static [EuvSidebarItem],
}

/// Props for the [`euv_sidebar`] component.
///
/// The `collapsed` signal is caller-owned so several sidebars (desktop aside
/// and mobile drawer) can share the collapse state; `prefix` is internal and
/// used by the recursion to key groups.
#[derive(Clone, CustomDebug, Default)]
pub struct EuvSidebarProps {
    /// The current route signal (drives the active link highlight).
    pub route_signal: Signal<String>,
    /// The collapsed group keys.
    pub collapsed: Signal<Vec<String>>,
    /// The tree items.
    pub items: &'static [EuvSidebarItem],
    /// The group key prefix (internal recursion state, leave default).
    pub prefix: String,
    /// Optional navigation interceptor receiving the target link; when set it
    /// replaces the default `Router::navigate` (used by drawers to close via
    /// the overlay stack).
    #[debug(skip)]
    pub on_navigate: Option<Rc<dyn Fn(&'static str)>>,
}

/// Props of the [`euv_sidebar_item`] component.
#[derive(Clone, CustomDebug, Default)]
pub struct EuvSidebarItemProps {
    /// The current route signal.
    pub route_signal: Signal<String>,
    /// The collapsed group keys.
    pub collapsed: Signal<Vec<String>>,
    /// The item to render.
    pub item: EuvSidebarItem,
    /// The group key prefix of the parent.
    pub prefix: String,
    /// Optional navigation interceptor (see [`EuvSidebarProps::on_navigate`]).
    #[debug(skip)]
    pub on_navigate: Option<Rc<dyn Fn(&'static str)>>,
}