guise/
paper.rs

1//! `Paper` — a raised surface: themed background, radius, padding, optional
2//! border and shadow. The base container most other surfaces build on.
3
4use gpui::prelude::*;
5use gpui::{div, px, AnyElement, App, Div, IntoElement, Window};
6
7use crate::devtools::Probed;
8use crate::theme::{theme, Size};
9
10/// A surface container.
11#[derive(IntoElement)]
12pub struct Paper {
13  children: Vec<AnyElement>,
14  padding: Size,
15  radius: Option<Size>,
16  with_border: bool,
17  shadow: Option<Size>,
18}
19
20impl Paper {
21  pub fn new() -> Self {
22    Paper {
23      children: Vec::new(),
24      padding: Size::Md,
25      radius: None,
26      with_border: false,
27      shadow: None,
28    }
29  }
30
31  pub fn padding(mut self, padding: Size) -> Self {
32    self.padding = padding;
33    self
34  }
35
36  pub fn radius(mut self, radius: Size) -> Self {
37    self.radius = Some(radius);
38    self
39  }
40
41  pub fn with_border(mut self, with_border: bool) -> Self {
42    self.with_border = with_border;
43    self
44  }
45
46  pub fn shadow(mut self, shadow: Size) -> Self {
47    self.shadow = Some(shadow);
48    self
49  }
50}
51
52impl Default for Paper {
53  fn default() -> Self {
54    Paper::new()
55  }
56}
57
58impl ParentElement for Paper {
59  fn extend(&mut self, elements: impl IntoIterator<Item = AnyElement>) {
60    self.children.extend(elements);
61  }
62}
63
64impl RenderOnce for Paper {
65  fn render(self, _window: &mut Window, cx: &mut App) -> impl IntoElement {
66    let t = theme(cx);
67    let radius = t.radius(self.radius.unwrap_or(t.default_radius));
68    let mut el = div()
69      .bg(t.surface().hsla())
70      .rounded(px(radius))
71      .p(px(t.spacing(self.padding)));
72    if self.with_border {
73      el = el.border_1().border_color(t.border().hsla());
74    }
75    el = apply_shadow(el, self.shadow);
76    el.children(self.children).probe("Paper")
77  }
78}
79
80pub(crate) fn apply_shadow(el: Div, shadow: Option<Size>) -> Div {
81  match shadow {
82    Some(Size::Xs) => el.shadow_xs(),
83    Some(Size::Sm) => el.shadow_sm(),
84    Some(Size::Md) => el.shadow_md(),
85    Some(Size::Lg) => el.shadow_lg(),
86    Some(Size::Xl) => el.shadow_xl(),
87    None => el,
88  }
89}
guise/paper.rs

guise/
paper.rs
