yororen_ui 0.2.0

Reusable UI components and widgets built on top of gpui.
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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165

use gpui::{
    Div, ElementId, Hsla, InteractiveElement, IntoElement, ParentElement, RenderOnce, Styled, div,
    prelude::FluentBuilder, px,
};

use crate::theme::ActiveTheme;

/// A row content container for list-style UIs.
///
/// Responsibilities:
/// - standard layout slots: leading / content / secondary / trailing
/// - hover + selected background
///
/// Note: virtualization shell responsibilities (spacing/dividers/stable row ids)
/// are handled by [`crate::component::VirtualRow`].
pub fn list_item() -> ListItem {
    ListItem::new()
}

#[derive(IntoElement)]
pub struct ListItem {
    element_id: ElementId,
    base: Div,
    leading: Option<gpui::AnyElement>,
    content: Option<gpui::AnyElement>,
    secondary: Option<gpui::AnyElement>,
    trailing: Option<gpui::AnyElement>,
    hoverable: bool,
    selected: bool,
    hover_bg: Option<Hsla>,
    selected_bg: Option<Hsla>,
}

impl Default for ListItem {
    fn default() -> Self {
        Self::new()
    }
}

impl ListItem {
    pub fn new() -> Self {
        Self {
            element_id: "ui:list-item".into(),
            base: div(),
            leading: None,
            content: None,
            secondary: None,
            trailing: None,
            hoverable: true,
            selected: false,
            hover_bg: None,
            selected_bg: None,
        }
    }

    pub fn id(mut self, id: impl Into<ElementId>) -> Self {
        self.element_id = id.into();
        self
    }

    /// Alias for `id(...)`. Use `key(...)` when you want to emphasize state identity.
    pub fn key(self, key: impl Into<ElementId>) -> Self {
        self.id(key)
    }

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

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

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

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

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

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

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

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

impl ParentElement for ListItem {
    fn extend(&mut self, elements: impl IntoIterator<Item = gpui::AnyElement>) {
        self.base.extend(elements);
    }
}

impl Styled for ListItem {
    fn style(&mut self) -> &mut gpui::StyleRefinement {
        self.base.style()
    }
}

impl RenderOnce for ListItem {
    fn render(self, _window: &mut gpui::Window, cx: &mut gpui::App) -> impl IntoElement {
        let hoverable = self.hoverable;
        let selected = self.selected;
        let hover_bg = self.hover_bg.unwrap_or(cx.theme().surface.hover);
        let selected_bg = self
            .selected_bg
            .unwrap_or(cx.theme().action.neutral.active_bg);

        let leading = self.leading;
        let content = self.content;
        let secondary = self.secondary;
        let trailing = self.trailing;

        self.base
            .id(self.element_id)
            .w_full()
            .min_h(px(32.))
            .px_3()
            .py_2()
            .rounded_md()
            .flex()
            .items_center()
            .gap_2()
            .when(selected, move |this| this.bg(selected_bg))
            .when(hoverable && !selected, move |this| {
                this.hover(|this| this.bg(hover_bg))
            })
            .children(leading)
            .child(
                div()
                    .flex()
                    .flex_col()
                    .gap_1()
                    .items_start()
                    .flex_grow()
                    .children(content)
                    .children(secondary.map(|el| {
                        div()
                            .text_sm()
                            .text_color(cx.theme().content.secondary)
                            .child(el)
                    })),
            )
            .children(trailing)
    }
}