ansiq-widgets 0.1.0

Widget builders and shell-oriented UI primitives for Ansiq.
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

use ansiq_core::{Element, ElementKind, GaugeProps, Layout, Length, Span, Style};

pub struct Gauge<Message = ()> {
    element: Element<Message>,
}

impl<Message> Default for Gauge<Message> {
    fn default() -> Self {
        Self {
            element: Element::new(ElementKind::Gauge(GaugeProps {
                block: None,
                ratio: 0.0,
                label: None,
                use_unicode: false,
                gauge_style: Style::default(),
            }))
            .with_layout(Layout {
                width: Length::Fill,
                height: Length::Auto,
            }),
        }
    }
}

impl<Message> Gauge<Message> {
    pub fn new() -> Self {
        Self::default()
    }

    pub fn block(mut self, block: crate::Block<Message>) -> Self {
        if let ElementKind::Gauge(props) = &mut self.element.kind {
            props.block = Some(block.into_frame());
        }
        self
    }

    pub fn percent(self, percent: u16) -> Self {
        assert!(
            percent <= 100,
            "Percentage should be between 0 and 100 inclusively."
        );
        self.ratio(f64::from(percent) / 100.0)
    }

    pub fn ratio(mut self, ratio: f64) -> Self {
        assert!(
            (0.0..=1.0).contains(&ratio),
            "Ratio should be between 0 and 1 inclusively."
        );
        if let ElementKind::Gauge(props) = &mut self.element.kind {
            props.ratio = ratio;
        }
        self
    }

    pub fn label<T>(mut self, label: T) -> Self
    where
        T: Into<Span>,
    {
        if let ElementKind::Gauge(props) = &mut self.element.kind {
            props.label = Some(label.into());
        }
        self
    }

    pub fn use_unicode(mut self, use_unicode: bool) -> Self {
        if let ElementKind::Gauge(props) = &mut self.element.kind {
            props.use_unicode = use_unicode;
        }
        self
    }

    pub fn gauge_style<S: Into<Style>>(mut self, style: S) -> Self {
        if let ElementKind::Gauge(props) = &mut self.element.kind {
            props.gauge_style = style.into();
        }
        self
    }

    pub fn layout(mut self, layout: Layout) -> Self {
        self.element.layout = layout;
        self
    }

    pub fn style<S: Into<Style>>(mut self, style: S) -> Self {
        self.element.style = style.into();
        self
    }

    pub fn build(self) -> Element<Message> {
        self.element
    }
}