use crate::component_prelude::*; use crate::prelude::*; use gpui::{AnyElement, IntoElement, ParentElement, StyleRefinement, Styled}; use smallvec::SmallVec; /// Creates a new [ContentGroup]. pub fn content_group() -> ContentGroup { ContentGroup::new() } /// A [ContentGroup] that vertically stacks its children. /// /// This is a convenience function that simply combines [`ContentGroup`] and [`v_flex`](crate::v_flex). pub fn v_container() -> ContentGroup { content_group().v_flex() } /// Creates a new horizontal [ContentGroup]. /// /// This is a convenience function that simply combines [`ContentGroup`] and [`h_flex`](crate::h_flex). pub fn h_container() -> ContentGroup { content_group().h_flex() } /// A flexible container component that can hold other elements. #[derive(IntoElement, Documented, RegisterComponent)] pub struct ContentGroup { base: Div, border: bool, fill: bool, children: SmallVec<[AnyElement; 2]>, } impl ContentGroup { /// Creates a new [`ContentGroup`]. pub fn new() -> Self { Self { base: div(), border: true, fill: true, children: SmallVec::new(), } } /// Removes the border from the [`ContentGroup`]. pub fn borderless(mut self) -> Self { self.border = false; self } /// Removes the background fill from the [`ContentGroup`]. pub fn unfilled(mut self) -> Self { self.fill = false; self } } impl ParentElement for ContentGroup { fn extend(&mut self, elements: impl IntoIterator) { self.children.extend(elements) } } impl Styled for ContentGroup { fn style(&mut self) -> &mut StyleRefinement { self.base.style() } } impl RenderOnce for ContentGroup { fn render(self, _window: &mut Window, cx: &mut App) -> impl IntoElement { // TODO: // Baked in padding will make scrollable views inside of content boxes awkward. // // Do we make the padding optional, or do we push to use a different component? self.base .when(self.fill, |this| { this.bg(cx.theme().colors().text.opacity(0.05)) }) .when(self.border, |this| { this.border_1().border_color(cx.theme().colors().border) }) .rounded_sm() .children(self.children) } } impl Component for ContentGroup { fn scope() -> ComponentScope { ComponentScope::Layout } fn description() -> Option<&'static str> { Some(ContentGroup::DOCS) } fn preview(_window: &mut Window, _cx: &mut App) -> Option { Some( example_group(vec![ single_example( "Default", ContentGroup::new() .flex_1() .items_center() .justify_center() .h_48() .child(Label::new("Default ContentGroup")) .into_any_element(), ).description("A contained style for laying out groups of content. Has a default background and border color."), single_example( "Without Border", ContentGroup::new() .flex_1() .items_center() .justify_center() .h_48() .borderless() .child(Label::new("Borderless ContentGroup")) .into_any_element(), ), single_example( "Without Fill", ContentGroup::new() .flex_1() .items_center() .justify_center() .h_48() .unfilled() .child(Label::new("Unfilled ContentGroup")) .into_any_element(), ), ]) .into_any_element(), ) } }