euv-ui 0.18.31

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
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

use super::*;

/// A dev-only component for inspecting reactive state inside the
/// component tree.
///
/// Renders a labelled readout block. The body is the result of
/// invoking the `value` closure on every render, which means
/// callers typically embed `Signal::get()` calls inside `value`
/// to subscribe the rendered vnode to live state changes.
///
/// The component emits `data-euv-debug` (on the outer wrapper),
/// `data-euv-debug-label` (on the label span), and
/// `data-euv-debug-value` (on the value element) so that
/// CSS / dev-tools / e2e tests can target each piece without
/// relying on class names.
///
/// # Arguments
///
/// - `VirtualNode<EuvDebugProps>` - The props node containing label,
///   value closure, and `expanded` flag.
///
/// # Returns
///
/// - `VirtualNode` - A labelled Debug readout element.
#[component]
pub fn euv_debug(node: VirtualNode<EuvDebugProps>) -> VirtualNode {
    let EuvDebugProps {
        label,
        value,
        expanded,
    }: EuvDebugProps = node.try_get_props().unwrap_or_default();
    // Render-time value: invoke the closure each render so that
    // any `Signal::get()` calls inside the closure subscribe the
    // rendered vnode to those signals. The closure is `Rc<dyn Fn>`,
    // not `FnMut`, so we cannot mutate captured state — but for a
    // Debug readout, producing a fresh `String` per render is the
    // right contract anyway.
    let rendered: String = match value.as_ref() {
        Some(formatter) => formatter(),
        // `value: None` means the caller constructed the
        // component without a formatter. Render an explicit
        // placeholder so the dev sees the missing-config issue
        // immediately (rather than an empty Debug box that
        // silently misleads them into thinking the value is
        // empty).
        None => String::from("<no formatter>"),
    };
    if expanded {
        html! {
            div {
                class: c_debug()
                data-euv-debug: "expanded"
                span {
                    class: c_debug_label()
                    data-euv-debug-label: label
                    label
                }
                pre {
                    class: c_debug_value()
                    data-euv-debug-value: "expanded"
                    rendered
                }
            }
        }
    } else {
        html! {
            div {
                class: c_debug()
                data-euv-debug: "inline"
                span {
                    class: c_debug_label()
                    data-euv-debug-label: label
                    label
                }
                code {
                    class: c_debug_value()
                    data-euv-debug-value: "inline"
                    rendered
                }
            }
        }
    }
}