mirui 0.38.0

A lightweight, no_std ECS-driven UI framework for embedded, desktop, and WebAssembly
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

extern crate alloc;
use alloc::format;

#[cfg(feature = "std")]
use crate::app::plugins::StdInstantClockPlugin;
use crate::core::reactive::{Computed, Signal};
use crate::prelude::*;
use crate::ui::IdMap;
use crate::ui::widgets::{Checkbox, Switch};

#[derive(Clone, Copy, Default)]
pub struct ToggleStats {
    pub switch_on: bool,
    pub switch_changes: u32,
    pub checkbox_checked: bool,
    pub checkbox_changes: u32,
}

/// Switch + Checkbox in modifier-chain form, each with `on Toggled` callback.
///
/// # Required plugins
/// - [`StdInstantClockPlugin`] — gesture timing
///
/// # Resources auto-inserted
/// - [`IdMap`] (if absent) — `find_by_id("toggle_label")`
/// - [`ToggleStats`] (if absent) — populated by the handlers
pub fn build_widgets(world: &mut World, parent: Entity) {
    if world.resource::<IdMap>().is_none() {
        world.insert_resource(IdMap::new());
    }

    let stats = Signal::new(ToggleStats::default());
    let (s_stats_r, s_checkbox, s_switch) = (stats.clone(), stats.clone(), stats.clone());
    let stats_text = Computed::new(move || {
        format!(
            "switch: {} ({} flips)   checkbox: {} ({} flips)",
            if s_stats_r.get().switch_on {
                "ON"
            } else {
                "OFF"
            },
            s_stats_r.get().switch_changes,
            if s_stats_r.get().checkbox_checked {
                "[x]"
            } else {
                "[ ]"
            },
            s_stats_r.get().checkbox_changes
        )
    });

    //~focus-start
    ui! {
        :(
            parent: parent
            world: world
        :)

        Column (grow: 1.0, padding: Padding::all(20)) {
            View (
                text: $stats_text,
                height: 30
            )
            Row (grow: 1.0, justify: JustifyContent::SpaceEvenly, align: AlignItems::Center) {
                Switch (width: 60, height: 32) on Toggled {
                    s_switch
                        .update(|s| {
                            s.switch_on = *now;
                            s.switch_changes += 1;
                        });
                }
                Checkbox (width: 32, height: 32) on Toggled {
                    s_checkbox
                        .update(|s| {
                            s.checkbox_checked = *now;
                            s.checkbox_changes += 1;
                        });
                }
            }
        }
    };
    //~focus-end
}

#[cfg(feature = "std")]
pub fn setup_app<B, F>(app: &mut App<B, F>, parent: Entity)
where
    B: Surface,
    F: RendererFactory<B>,
{
    app.add_plugin(StdInstantClockPlugin);
    build_widgets(&mut app.world, parent);
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::ui::Children;

    #[test]
    fn build_widgets_smoke() {
        let mut world = World::new();
        let parent = WidgetBuilder::new(&mut world).id();
        build_widgets(&mut world, parent);
        assert!(
            world
                .get::<Children>(parent)
                .is_some_and(|c| !c.0.is_empty())
        );
    }
}