mirui 0.33.1

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

//! Built entirely through the widget builder API — `X::build(..)` +
//! `world.spawn(..)` + `spawn_children` closures — with no `ui!` macro.
//! Every other demo uses the DSL; this one shows the hand-written path
//! that non-macro users (and the macro itself) lower to.

#[cfg(feature = "std")]
use crate::app::plugins::StdInstantClockPlugin;
#[cfg(feature = "std")]
use crate::app::{App, RendererFactory};
use crate::ecs::{Entity, World};
#[cfg(feature = "std")]
use crate::prelude::plugin::FpsSummaryPlugin;
#[cfg(feature = "std")]
use crate::surface::Surface;
use crate::types::{Dimension, Fixed};
use crate::ui::Style;
use crate::ui::layout::{FlexDirection, LayoutStyle};
use crate::ui::spawn_children;
use crate::ui::theme::ColorToken;
use crate::ui::widgets::{ProgressBar, Slider, Switch};

fn column_style() -> Style {
    Style {
        layout: LayoutStyle {
            direction: FlexDirection::Column,
            grow: Fixed::from_int(1),
            padding: crate::ui::layout::Padding {
                top: Dimension::px(12),
                left: Dimension::px(12),
                right: Dimension::px(12),
                bottom: Dimension::px(12),
            },
            ..Default::default()
        },
        ..Default::default()
    }
}

fn row_style(height: i32) -> Style {
    Style {
        layout: LayoutStyle {
            height: Dimension::px(height),
            ..Default::default()
        },
        ..Default::default()
    }
}

pub fn build_widgets(world: &mut World, parent: Entity) {
    //~focus-start
    let column = spawn_children(world, column_style(), |c| {
        c.spawn(
            Slider::build(Fixed::ZERO, Fixed::from_int(100))
                .style(row_style(20))
                .fill_color(ColorToken::Primary),
        );
        c.spawn(Switch::build().style(row_style(26)));
        c.spawn(ProgressBar::build().value(0.6).style(row_style(12)));
    });
    //~focus-end

    world.insert(column, crate::ui::Parent(parent));
    if let Some(children) = world.get_mut::<crate::ui::Children>(parent) {
        children.0.push(column);
    }
}

#[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)
        .add_plugin(FpsSummaryPlugin::default());
    build_widgets(&mut app.world, parent);
}

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

    #[test]
    fn build_widgets_smoke() {
        let mut world = World::new();
        world.insert_resource(IdMap::new());
        let parent = WidgetBuilder::new(&mut world).id();
        build_widgets(&mut world, parent);
        let column = world
            .get::<Children>(parent)
            .and_then(|c| c.0.first().copied());
        let column = column.expect("column parented");
        assert_eq!(world.get::<Children>(column).map(|c| c.0.len()), Some(3));
        assert!(world.has::<Slider>(world.get::<Children>(column).unwrap().0[0]));
    }
}