decal 0.6.0

Declarative DSL for describing scenes and rendering them to SVG or PNG
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

use crate::{
    capabilities::*,
    layout::{
        Node,
        NodeKind,
        Typography,
    },
    macros::impl_node_builder,
    paint::{
        Appearance,
        Resource,
    },
    primitives::{
        Display,
        FlexDirection,
    },
};
use taffy::Style;

/// Block node.
#[derive(Debug, Default)]
pub struct Block {
    layout: Style,
    visual: Appearance,
    typography: Typography,
    resources: Vec<Resource>,
    /// Last non-none display value preserved for visibility toggling.
    last_display: taffy::Display,
}

impl_node_builder! {
    Block,
    build(this) {
        Node::new(
            NodeKind::Block,
            this.layout,
            this.visual,
            Some(this.typography),
            this.resources
        )
    }
}

impl Block {
    /// Creates a new block node.
    ///
    /// # Returns
    /// - [`Self`]
    pub fn new() -> Self {
        Self {
            layout: Style {
                display: taffy::Display::Block,
                ..Default::default()
            },
            ..Default::default()
        }
    }

    /// Sets the display mode of the block.
    ///
    /// # Arguments
    /// - `display`: The [`Display`] property for the block.
    ///
    /// # Returns
    /// - [`Self`]
    pub fn display(mut self, display: Display) -> Self {
        self.layout.display = display.into();
        self
    }

    /// Sets the flex direction used when the block is set to [`Display::Flex`].
    ///
    /// # Arguments
    /// - `direction`: The [`FlexDirection`] to apply.
    ///
    /// # Returns
    /// - [`Self`]
    pub fn flex_direction(mut self, direction: FlexDirection) -> Self {
        self.layout.flex_direction = direction.into();
        self
    }

    /// Sets display property of the block to [`Display::Flex`] with direction
    /// set to [`FlexDirection::Column`].
    ///
    /// # Returns
    /// - [`Self`]
    pub fn flex_col(self) -> Self {
        self.display(Display::Flex)
            .flex_direction(FlexDirection::Column)
    }

    /// Sets display property of the block to [`Display::Flex`] with direction
    /// set to [`FlexDirection::Row`].
    ///
    /// # Returns
    /// - [`Self`]
    pub fn flex_row(self) -> Self {
        self.display(Display::Flex)
            .flex_direction(FlexDirection::Row)
    }
}

impl Hideable for Block {
    fn hidden(mut self, value: bool) -> Self {
        self.layout.display = if value {
            self.last_display = self.layout.display;
            taffy::Display::None
        } else {
            self.last_display
        };

        self
    }
}

impl AspectRatio for Block {}
impl Background for Block {}
impl Border for Block {}
impl RoundedCorners for Block {}
impl Dimensions for Block {}
impl Gap for Block {}
impl ContainerAlignment for Block {}
impl FlexContainer for Block {}
impl SelfAlignment for Block {}
impl Margin for Block {}
impl Padding for Block {}
impl Clippable for Block {}
impl Opacity for Block {}
impl Visibility for Block {}
impl Positioned for Block {}
impl Transformation for Block {}
impl Textual for Block {}
impl FilterEffects for Block {}
impl Blendable for Block {}

#[cfg(feature = "grid")]
impl GridContainer for Block {}