rlvgl-ui 0.1.0

High-level UI components and theming for rlvgl.
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

// SPDX-License-Identifier: MIT
//! Text and heading helpers for rlvgl-ui.
//!
//! Provides simple wrappers around the base label widget for body text and
//! semantic headings.

use rlvgl_core::{
    event::Event,
    renderer::Renderer,
    widget::{Rect, Widget},
};
use rlvgl_widgets::label::Label;

/// Text wrapper around the [`Label`] widget.
pub struct Text {
    inner: Label,
}

impl Text {
    /// Create a new text element with the provided content and bounds.
    pub fn new(text: &str, bounds: Rect) -> Self {
        let inner = Label::new(text, bounds);
        Self { inner }
    }

    /// Immutable access to the text style.
    pub fn style(&self) -> &rlvgl_core::style::Style {
        &self.inner.style
    }

    /// Mutable access to the text style.
    pub fn style_mut(&mut self) -> &mut rlvgl_core::style::Style {
        &mut self.inner.style
    }

    /// Update the displayed text.
    pub fn set_text(&mut self, text: &str) {
        self.inner.set_text(text);
    }

    /// Retrieve the current text content.
    pub fn text(&self) -> &str {
        self.inner.text()
    }
}

impl Widget for Text {
    fn bounds(&self) -> Rect {
        self.inner.bounds()
    }

    fn draw(&self, renderer: &mut dyn Renderer) {
        self.inner.draw(renderer);
    }

    fn handle_event(&mut self, event: &Event) -> bool {
        self.inner.handle_event(event)
    }
}

/// Heading wrapper applying semantic emphasis.
pub struct Heading {
    inner: Text,
}

impl Heading {
    /// Create a new heading element with the provided text and bounds.
    pub fn new(text: &str, bounds: Rect) -> Self {
        let inner = Text::new(text, bounds);
        Self { inner }
    }

    /// Immutable access to the heading style.
    pub fn style(&self) -> &rlvgl_core::style::Style {
        self.inner.style()
    }

    /// Mutable access to the heading style.
    pub fn style_mut(&mut self) -> &mut rlvgl_core::style::Style {
        self.inner.style_mut()
    }

    /// Retrieve the heading text.
    pub fn text(&self) -> &str {
        self.inner.text()
    }
}

impl Widget for Heading {
    fn bounds(&self) -> Rect {
        self.inner.bounds()
    }

    fn draw(&self, renderer: &mut dyn Renderer) {
        self.inner.draw(renderer);
    }

    fn handle_event(&mut self, event: &Event) -> bool {
        self.inner.handle_event(event)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use rlvgl_core::widget::Rect;

    #[test]
    fn text_updates_content() {
        let mut txt = Text::new(
            "hello",
            Rect {
                x: 0,
                y: 0,
                width: 10,
                height: 10,
            },
        );
        txt.set_text("world");
        assert_eq!(txt.text(), "world");
    }

    #[test]
    fn heading_uses_text() {
        let heading = Heading::new(
            "title",
            Rect {
                x: 0,
                y: 0,
                width: 10,
                height: 10,
            },
        );
        assert_eq!(heading.text(), "title");
    }
}