guise/layout/
space.rs

1//! `Space` — a fixed spacing block on one axis, sized by the theme's
2//! spacing scale.
3//!
4//! ```ignore
5//! use guise::prelude::*;
6//!
7//! Stack::new()
8//!     .child(Title::new("Heading").order(3))
9//!     .child(Space::y(Size::Md))
10//!     .child(Text::new("Body copy."))
11//! ```
12
13use gpui::prelude::*;
14use gpui::{div, px, App, IntoElement, Window};
15
16use crate::devtools::Probed;
17use crate::theme::{theme, Size};
18
19/// The axis a [`Space`] occupies.
20#[derive(Debug, Clone, Copy, PartialEq, Eq)]
21enum SpaceAxis {
22  Horizontal,
23  Vertical,
24}
25
26/// A fixed gap between siblings.
27#[derive(IntoElement)]
28pub struct Space {
29  axis: SpaceAxis,
30  size: Size,
31}
32
33impl Space {
34  /// Horizontal space: a block `size` wide (for rows).
35  pub fn x(size: Size) -> Self {
36    Space {
37      axis: SpaceAxis::Horizontal,
38      size,
39    }
40  }
41
42  /// Vertical space: a block `size` tall (for columns).
43  pub fn y(size: Size) -> Self {
44    Space {
45      axis: SpaceAxis::Vertical,
46      size,
47    }
48  }
49}
50
51impl RenderOnce for Space {
52  fn render(self, _window: &mut Window, cx: &mut App) -> impl IntoElement {
53    let gap = theme(cx).spacing(self.size);
54    let el = div().flex_none();
55
56    let element = match self.axis {
57      SpaceAxis::Horizontal => el.w(px(gap)),
58      SpaceAxis::Vertical => el.h(px(gap)),
59    };
60
61    element.probe("Space")
62  }
63}
guise/layout/space.rs

guise/layout/
space.rs
