boltz-ui 0.2.21

High-level reusable GPUI UI components (Label, Button, Input, etc.).
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

use gpui::{AnyElement, FontWeight};

use crate::prelude::*;

/// A centered placeholder shown when a list/table/collection has no content.
#[derive(IntoElement, RegisterComponent)]
pub struct EmptyState {
    icon: IconName,
    heading: SharedString,
    description: Option<SharedString>,
    action: Option<AnyElement>,
}

impl EmptyState {
    pub fn new(heading: impl Into<SharedString>) -> Self {
        Self {
            icon: IconName::User,
            heading: heading.into(),
            description: None,
            action: None,
        }
    }

    pub fn icon(mut self, icon: IconName) -> Self {
        self.icon = icon;
        self
    }

    pub fn description(mut self, description: impl Into<SharedString>) -> Self {
        self.description = Some(description.into());
        self
    }

    pub fn action(mut self, action: impl IntoElement) -> Self {
        self.action = Some(action.into_any_element());
        self
    }
}

impl RenderOnce for EmptyState {
    fn render(self, _window: &mut Window, cx: &mut App) -> impl IntoElement {
        v_flex()
            .w_full()
            .items_center()
            .justify_center()
            .gap_2()
            .py_12()
            .child(
                Icon::new(self.icon)
                    .size(IconSize::XLarge)
                    .color(Color::Custom(semantic::text_muted(cx))),
            )
            .child(Label::new(self.heading).weight(FontWeight::MEDIUM))
            .children(
                self.description
                    .map(|d| Label::new(d).size(LabelSize::Small).color(Color::Muted)),
            )
            .children(self.action)
    }
}

impl Component for EmptyState {
    fn scope() -> ComponentScope {
        ComponentScope::DataDisplay
    }

    fn description() -> Option<&'static str> {
        Some("A centered placeholder shown when a list/table/collection has no content.")
    }

    fn preview(_window: &mut Window, _cx: &mut App) -> Option<AnyElement> {
        Some(
            v_flex()
                .gap_6()
                .children(vec![
                    example_group_with_title(
                        "Basic",
                        vec![single_example(
                            "No description",
                            EmptyState::new("No projects").into_any_element(),
                        )],
                    ),
                    example_group_with_title(
                        "With description and action",
                        vec![single_example(
                            "Full",
                            EmptyState::new("No projects")
                                .icon(IconName::File)
                                .description("Get started by creating a new project.")
                                .action(Button::new("new_project", "New Project"))
                                .into_any_element(),
                        )],
                    ),
                ])
                .into_any_element(),
        )
    }
}