faststep 0.1.0

UIKit-inspired embedded UI framework built on embedded-graphics
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

use embedded_graphics::{
    mono_font::{
        MonoTextStyleBuilder,
        ascii::{FONT_7X14, FONT_9X18_BOLD},
    },
    pixelcolor::Rgb565,
    prelude::*,
    primitives::{PrimitiveStyle, PrimitiveStyleBuilder, Rectangle, RoundedRectangle},
    text::{Alignment, Baseline, Text, TextStyleBuilder},
};

use crate::alert_layout::{alert_layout, alert_layout_in_panel, button_frames, message_top};
use crate::{
    Button, ButtonKind, ButtonSpec, ButtonTouchResponse, ButtonTouchState, FsTheme, I18n,
    TouchEvent,
};

use super::{AlertButtonRole, AlertKind, AlertSpec};

/// Drawable alert widget for one [`AlertSpec`].
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct AlertView<'a, const N: usize> {
    /// Immutable alert specification.
    pub spec: AlertSpec<'a, N>,
    touch_state: ButtonTouchState<u8>,
}

impl<'a, const N: usize> AlertView<'a, N> {
    /// Creates an alert view for a specification.
    pub const fn new(spec: AlertSpec<'a, N>) -> Self {
        Self {
            spec,
            touch_state: ButtonTouchState::new(),
        }
    }

    /// Clears transient button state.
    pub fn clear_touch_state(&mut self) {
        self.touch_state.clear();
    }

    /// Returns the preferred panel rectangle for the alert.
    pub fn panel(&self, bounds: Rectangle, theme: &FsTheme, i18n: &I18n<'a>) -> Rectangle {
        alert_layout::<N>(bounds, theme, i18n.text(self.spec.message)).panel
    }

    /// Routes one touch event to the alert buttons.
    pub fn handle_touch(&mut self, touch: TouchEvent, panel: Rectangle) -> ButtonTouchResponse<u8> {
        let buttons = self.buttons(panel);
        self.touch_state.handle_touch(touch, &buttons)
    }

    /// Draws the alert.
    pub fn draw<D>(&self, display: &mut D, panel: Rectangle, theme: &FsTheme, i18n: &I18n<'a>)
    where
        D: embedded_graphics::draw_target::DrawTarget<Color = Rgb565>,
    {
        self.draw_state(display, panel, theme, i18n);
    }

    /// Draws the alert using the current touch state.
    pub fn draw_state<D>(&self, display: &mut D, panel: Rectangle, theme: &FsTheme, i18n: &I18n<'a>)
    where
        D: embedded_graphics::draw_target::DrawTarget<Color = Rgb565>,
    {
        let layout = alert_layout_in_panel::<N>(panel, i18n.text(self.spec.message));
        RoundedRectangle::with_equal_corners(
            Rectangle::new(panel.top_left + Point::new(6, 8), panel.size),
            Size::new(22, 22),
        )
        .into_styled(PrimitiveStyle::with_fill(theme.dim))
        .draw(display)
        .ok();

        let panel_style = PrimitiveStyleBuilder::new()
            .fill_color(theme.surface)
            .stroke_color(theme.surface_alt)
            .stroke_width(2)
            .build();
        RoundedRectangle::with_equal_corners(panel, Size::new(22, 22))
            .into_styled(panel_style)
            .draw(display)
            .ok();

        let title_style = MonoTextStyleBuilder::new()
            .font(&FONT_9X18_BOLD)
            .text_color(kind_color(self.spec.kind, theme))
            .build();
        let message_style = MonoTextStyleBuilder::new()
            .font(&FONT_7X14)
            .text_color(theme.text_secondary)
            .build();
        let text_style = TextStyleBuilder::new()
            .alignment(Alignment::Center)
            .baseline(Baseline::Middle)
            .build();

        Text::with_text_style(
            i18n.text(self.spec.title),
            panel.center() + Point::new(0, -40),
            title_style,
            text_style,
        )
        .draw(display)
        .ok();
        for (index, line) in layout.message_lines.iter().enumerate() {
            Text::with_text_style(
                line,
                Point::new(panel.center().x, message_top(panel) + (index as i32 * 18)),
                message_style,
                text_style,
            )
            .draw(display)
            .ok();
        }

        for button in self.buttons(panel) {
            button.draw_state(
                display,
                theme,
                i18n,
                self.touch_state.is_highlighted(&button),
            );
        }
    }

    fn buttons(&self, panel: Rectangle) -> [Button<'a, u8>; N] {
        core::array::from_fn(|index| {
            let action = self.spec.actions[index];
            Button::new(
                button_frames::<N>(panel)[index],
                ButtonSpec {
                    key: action.id,
                    icon: None,
                    label: action.label,
                    kind: button_kind(action.role),
                },
            )
        })
    }
}

fn kind_color(kind: AlertKind, theme: &FsTheme) -> Rgb565 {
    match kind {
        AlertKind::Error => theme.danger,
        AlertKind::Warning => theme.warning,
        AlertKind::Confirm => theme.accent,
    }
}

fn button_kind(role: AlertButtonRole) -> ButtonKind {
    match role {
        AlertButtonRole::Primary => ButtonKind::Primary,
        AlertButtonRole::Secondary => ButtonKind::Secondary,
        AlertButtonRole::Destructive => ButtonKind::Destructive,
    }
}