euv-ui 0.28.1

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

use super::*;

/// The largest percentage a progress bar fill can occupy.
const PERCENT_MAX: f64 = 100.0;

/// A determinate progress bar component bound to a percentage signal.
///
/// Renders a `c_progress_container` track holding a
/// `c_progress_bar_fill` element whose inline `width` is driven by the
/// `percent` signal, plus the label and a numeric readout. A running bar
/// adds the animated `c_progress_bar_running` class; a settled one falls
/// back to `c_progress_bar_stopped` so the fill keeps its inline width
/// without re-running the keyframe animation.
///
/// # Arguments
///
/// - `VirtualNode<EuvProgressProps>` - The props node containing bar configuration.
///
/// # Returns
///
/// - `VirtualNode` - A styled progress bar.
#[component]
pub fn euv_progress(node: VirtualNode<EuvProgressProps>) -> VirtualNode {
    let EuvProgressProps {
        percent,
        label: label_text,
        active,
    }: EuvProgressProps = node.try_get_props().unwrap_or_default();
    let clamped: f64 = progress_percent_clamp(percent.get());
    let fill_style: String = format!("width: {clamped}%;");
    let fill_style_ref: &str = fill_style.as_str();
    let readout: String = format!("{clamped:.0}%");
    html! {
        div {
            div {
                class: c_progress_container()
                div {
                    class: c_progress_bar_fill()
                    class: if { active } {
                        c_progress_bar_running()
                    } else {
                        c_progress_bar_stopped()
                    }
                    style: fill_style_ref
                }
            }
            div {
                class: c_euv_slider_header()
                span {
                    class: c_form_label()
                    label_text
                }
                span {
                    class: c_binding_slider_value()
                    readout
                }
            }
        }
    }
}

/// Clamps a raw percentage into the `0.0..=100.0` range a bar can render.
///
/// NaN collapses to `0.0` — a `Signal<f64>` carrying NaN (an
/// unreported upload size, a `0.0 / 0.0` ratio) would otherwise emit a
/// `width: NaN%` declaration the browser drops silently.
///
/// # Arguments
///
/// - `f64` - The raw percentage supplied by the caller.
///
/// # Returns
///
/// - `f64` - The percentage clamped into the `0.0..=100.0` range.
pub fn progress_percent_clamp(percent: f64) -> f64 {
    if percent.is_nan() {
        return 0.0;
    }
    percent.clamp(0.0, PERCENT_MAX)
}