grx 0.3.2

Abstraction layer for UI development
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: GPL-3.0-or-later

//! TailwindCSS inspired style definitions.
//!
//! grx components can be styled using the `Style` enum.

#[derive(PartialEq, Debug, Eq, Clone)]
#[allow(non_camel_case_types)]
pub enum Modifier {
    none,
    /// Apply this style when a component is hovered
    hover,
    active,
}
impl Default for Modifier {
    fn default() -> Self {
        Self::none
    }
}

#[derive(PartialEq, Debug, Eq, Clone)]
#[allow(non_camel_case_types)]
pub enum Style {
    none(Modifier),
    bg(Modifier, String),
    /// Margin for all 4 sides.
    m(Modifier, u32),
    mx(Modifier, u32),
    my(Modifier, u32),
    mt(Modifier, u32),
    mb(Modifier, u32),
    ml(Modifier, u32),
    mr(Modifier, u32),
    /// Padding for all 4 sides
    p(Modifier, u32),
    px(Modifier, u32),
    py(Modifier, u32),
    pt(Modifier, u32),
    pb(Modifier, u32),
    pl(Modifier, u32),
    pr(Modifier, u32),

    target(Modifier, bool),

    /// whether a container is layouted vertical
    vertical(Modifier),
    /// whether a container is layouted horizontal
    horizontal(Modifier),
    /// spacing between children of a container
    spacing(Modifier, u32),
    /// How to align an element in relation to its parent
    halign(Modifier, Align),
    /// How to align an element in relation to its parent
    valign(Modifier, Align),

    overflow(Modifier, Overflow),

    text(Modifier, String),
    justify(Modifier, Justify),
    text_size(Modifier, String),
    wrap(Modifier, Wrap),
    selectable(Modifier),
    ellipsize(Modifier, Align),

    vexpand(Modifier),
    hexpand(Modifier),
    homogeneous(Modifier),

    //borders
    border_color(Modifier, String),
    /// border (top, right, bottom, left)
    border(Modifier, u32, u32, u32, u32),
    border_x(Modifier, u32),
    border_y(Modifier, u32),
    border_r(Modifier, u32),
    border_l(Modifier, u32),
    border_t(Modifier, u32),
    border_b(Modifier, u32),

    // The height in pixel
    h(Modifier, u32),
    // The width in pixel
    w(Modifier, u32),

    rounded_full(Modifier),
}

#[cfg(feature = "gtk")]
pub fn apply<C>(style: &Style, component: &std::rc::Rc<C>)
where
    C: crate::ComponentExt + ?Sized,
{
    let inner = component.clone().inner();
    let w: &gtk::Widget = inner.downcast_ref().unwrap();
    Stylable::apply(style, w);
}

pub trait Stylable<T> {
    fn apply(&self, inner: &T);
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[allow(non_camel_case_types)]
pub enum Align {
    none,
    start,
    center,
    end,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[allow(non_camel_case_types)]
pub enum Justify {
    left,
    right,
    middle,
    fill,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[allow(non_camel_case_types)]
pub enum Wrap {
    char,
    word,
    word_char,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[allow(non_camel_case_types)]
pub enum Overflow {
    never,
    external,
    horizontal,
    vertical,
    both,
}