densa-widgets 0.2.2

Standard widgets for densa: labels, buttons, text inputs, scroll views, splitters, docking
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

use densa_core::{Color, Point, Size};
use densa_draw::Canvas;
use densa_ui::{AccessNode, Constraints, EventCx, LayoutCx, PaintCx, Role, Theme, Widget};

use crate::text::Text;

/// Text, on one line or wrapped to its width, vertically centered in its rectangle.
#[derive(Debug)]
pub struct Label {
    text: Text,
    dim: bool,
    centered: bool,
}

impl Label {
    /// `text` on one line, in the theme's text color and size.
    pub fn new(text: impl Into<String>) -> Self {
        Self {
            text: Text::new(text),
            dim: false,
            centered: false,
        }
    }

    /// The label in the theme's secondary text color.
    #[must_use]
    pub fn dim(mut self) -> Self {
        self.dim = true;
        self
    }

    /// The label at `size` logical pixels instead of the theme's size.
    #[must_use]
    pub fn with_size(mut self, size: f32) -> Self {
        self.text.set_size(size);
        self
    }

    /// The label wrapped onto more lines at the width layout gives it.
    #[must_use]
    pub fn wrapping(mut self) -> Self {
        self.text.set_wrap(true);
        self
    }

    /// The label centered horizontally too.
    #[must_use]
    pub fn centered(mut self) -> Self {
        self.centered = true;
        self
    }

    /// The text shown.
    pub fn text(&self) -> &str {
        self.text.as_str()
    }

    /// Shows `text` instead, measured again at the next layout.
    pub fn set_text(&mut self, cx: &mut EventCx<'_>, text: impl Into<String>) {
        self.text.set(text);
        cx.request_layout();
    }

    fn color(&self, theme: &Theme) -> Color {
        if self.dim {
            theme.text_dim
        } else {
            theme.text
        }
    }
}

impl Widget for Label {
    fn accessibility(&self, _: &PaintCx<'_>, node: &mut AccessNode) {
        node.set_role(Role::Label);
        node.set_value(self.text.as_str());
    }

    fn measure(&mut self, cx: &mut LayoutCx<'_>, constraints: Constraints) -> Size {
        let color = self.color(cx.theme());
        self.text.measure(cx, constraints, color)
    }

    fn layout(&mut self, cx: &mut LayoutCx<'_>, size: Size) {
        let color = self.color(cx.theme());
        self.text.fit(cx, size.width, color);
    }

    fn paint(&mut self, cx: &PaintCx<'_>, canvas: &mut Canvas<'_>) {
        let content = cx.content_rect();
        let size = self.text.size();
        let mut origin = crate::paint::centered(content, size.width, size.height);
        if !self.centered {
            origin = Point::new(content.left(), origin.y);
        }
        self.text.paint(canvas, origin);
    }
}