Struct ContainerBuilder 

pub struct ContainerBuilder<'a> { /* private fields */ }

Fluent builder for configuring containers before calling .col() or .row().

Obtain one via Context::container or Context::bordered. Chain the configuration methods you need, then finalize with .col(|ui| { ... }) or .row(|ui| { ... }).

Example

use slt::{Border, Color};
ui.container()
    .border(Border::Rounded)
    .pad(1)
    .grow(1)
    .col(|ui| {
        ui.text("inside a bordered, padded, growing column");
    });

Implementations

impl<'a> ContainerBuilder<'a>

pub fn apply(self, style: &ContainerStyle) -> Self

Apply a reusable ContainerStyle recipe. Only set fields override the builder’s current values. Chain multiple .apply() calls to compose.

pub fn border(self, border: Border) -> Self

Set the border style.

pub fn border_top(self, show: bool) -> Self

Show or hide the top border.

pub fn border_right(self, show: bool) -> Self

Show or hide the right border.

pub fn border_bottom(self, show: bool) -> Self

Show or hide the bottom border.

pub fn border_left(self, show: bool) -> Self

Show or hide the left border.

pub fn border_sides(self, sides: BorderSides) -> Self

Set which border sides are visible.

pub fn rounded(self) -> Self

Set rounded border style. Shorthand for .border(Border::Rounded).

pub fn border_style(self, style: Style) -> Self

Set the style applied to the border characters.

pub fn dark_border_style(self, style: Style) -> Self

Border style used when dark mode is active.

pub fn bg(self, color: Color) -> Self

pub fn dark_bg(self, color: Color) -> Self

Background color used when dark mode is active.

pub fn group_hover_bg(self, color: Color) -> Self

Background color applied when the parent group is hovered.

pub fn group_hover_border_style(self, style: Style) -> Self

Border style applied when the parent group is hovered.

pub fn p(self, value: u32) -> Self

Set uniform padding on all sides. Alias for pad.

pub fn pad(self, value: u32) -> Self

Set uniform padding on all sides.

pub fn px(self, value: u32) -> Self

Set horizontal padding (left and right).

pub fn py(self, value: u32) -> Self

Set vertical padding (top and bottom).

pub fn pt(self, value: u32) -> Self

Set top padding.

pub fn pr(self, value: u32) -> Self

Set right padding.

pub fn pb(self, value: u32) -> Self

Set bottom padding.

pub fn pl(self, value: u32) -> Self

Set left padding.

pub fn padding(self, padding: Padding) -> Self

Set per-side padding using a Padding value.

pub fn m(self, value: u32) -> Self

Set uniform margin on all sides.

pub fn mx(self, value: u32) -> Self

Set horizontal margin (left and right).

pub fn my(self, value: u32) -> Self

Set vertical margin (top and bottom).

pub fn mt(self, value: u32) -> Self

Set top margin.

pub fn mr(self, value: u32) -> Self

Set right margin.

pub fn mb(self, value: u32) -> Self

Set bottom margin.

pub fn ml(self, value: u32) -> Self

Set left margin.

pub fn margin(self, margin: Margin) -> Self

Set per-side margin using a Margin value.

pub fn w(self, value: u32) -> Self

Set a fixed width (sets both min and max width).

pub fn xs_w(self, value: u32) -> Self

Width applied only at Xs breakpoint (< 40 cols).

Example

ui.container().w(20).md_w(40).lg_w(60).col(|ui| { ... });

pub fn sm_w(self, value: u32) -> Self

Width applied only at Sm breakpoint (40-79 cols).

pub fn md_w(self, value: u32) -> Self

Width applied only at Md breakpoint (80-119 cols).

pub fn lg_w(self, value: u32) -> Self

Width applied only at Lg breakpoint (120-159 cols).

pub fn xl_w(self, value: u32) -> Self

Width applied only at Xl breakpoint (>= 160 cols).

pub fn w_at(self, bp: Breakpoint, value: u32) -> Self

pub fn h(self, value: u32) -> Self

Set a fixed height (sets both min and max height).

pub fn xs_h(self, value: u32) -> Self

Height applied only at Xs breakpoint (< 40 cols).

pub fn sm_h(self, value: u32) -> Self

Height applied only at Sm breakpoint (40-79 cols).

pub fn md_h(self, value: u32) -> Self

Height applied only at Md breakpoint (80-119 cols).

pub fn lg_h(self, value: u32) -> Self

Height applied only at Lg breakpoint (120-159 cols).

pub fn xl_h(self, value: u32) -> Self

Height applied only at Xl breakpoint (>= 160 cols).

pub fn h_at(self, bp: Breakpoint, value: u32) -> Self

pub fn min_w(self, value: u32) -> Self

Set the minimum width constraint. Shorthand for min_width.

pub fn xs_min_w(self, value: u32) -> Self

Minimum width applied only at Xs breakpoint (< 40 cols).

pub fn sm_min_w(self, value: u32) -> Self

Minimum width applied only at Sm breakpoint (40-79 cols).

pub fn md_min_w(self, value: u32) -> Self

Minimum width applied only at Md breakpoint (80-119 cols).

pub fn lg_min_w(self, value: u32) -> Self

Minimum width applied only at Lg breakpoint (120-159 cols).

pub fn xl_min_w(self, value: u32) -> Self

Minimum width applied only at Xl breakpoint (>= 160 cols).

pub fn min_w_at(self, bp: Breakpoint, value: u32) -> Self

pub fn max_w(self, value: u32) -> Self

Set the maximum width constraint. Shorthand for max_width.

pub fn xs_max_w(self, value: u32) -> Self

Maximum width applied only at Xs breakpoint (< 40 cols).

pub fn sm_max_w(self, value: u32) -> Self

Maximum width applied only at Sm breakpoint (40-79 cols).

pub fn md_max_w(self, value: u32) -> Self

Maximum width applied only at Md breakpoint (80-119 cols).

pub fn lg_max_w(self, value: u32) -> Self

Maximum width applied only at Lg breakpoint (120-159 cols).

pub fn xl_max_w(self, value: u32) -> Self

Maximum width applied only at Xl breakpoint (>= 160 cols).

pub fn max_w_at(self, bp: Breakpoint, value: u32) -> Self

pub fn min_h(self, value: u32) -> Self

Set the minimum height constraint. Shorthand for min_height.

pub fn max_h(self, value: u32) -> Self

Set the maximum height constraint. Shorthand for max_height.

pub fn min_width(self, value: u32) -> Self

Set the minimum width constraint in cells.

pub fn max_width(self, value: u32) -> Self

Set the maximum width constraint in cells.

pub fn min_height(self, value: u32) -> Self

Set the minimum height constraint in rows.

pub fn max_height(self, value: u32) -> Self

Set the maximum height constraint in rows.

pub fn w_pct(self, pct: u8) -> Self

Set width as a percentage (1-100) of the parent container.

pub fn h_pct(self, pct: u8) -> Self

Set height as a percentage (1-100) of the parent container.

pub fn constraints(self, constraints: Constraints) -> Self

Set all size constraints at once using a Constraints value.

pub fn gap(self, gap: u32) -> Self

Set the gap (in cells) between child elements.

pub fn xs_gap(self, value: u32) -> Self

Gap applied only at Xs breakpoint (< 40 cols).

pub fn sm_gap(self, value: u32) -> Self

Gap applied only at Sm breakpoint (40-79 cols).

pub fn md_gap(self, value: u32) -> Self

Gap applied only at Md breakpoint (80-119 cols).

Example

ui.container().gap(0).md_gap(2).col(|ui| { ... });

pub fn lg_gap(self, value: u32) -> Self

Gap applied only at Lg breakpoint (120-159 cols).

pub fn xl_gap(self, value: u32) -> Self

Gap applied only at Xl breakpoint (>= 160 cols).

pub fn gap_at(self, bp: Breakpoint, value: u32) -> Self

pub fn grow(self, grow: u16) -> Self

Set the flex-grow factor. 1 means the container expands to fill available space.

pub fn xs_grow(self, value: u16) -> Self

Grow factor applied only at Xs breakpoint (< 40 cols).

pub fn sm_grow(self, value: u16) -> Self

Grow factor applied only at Sm breakpoint (40-79 cols).

pub fn md_grow(self, value: u16) -> Self

Grow factor applied only at Md breakpoint (80-119 cols).

pub fn lg_grow(self, value: u16) -> Self

Grow factor applied only at Lg breakpoint (120-159 cols).

pub fn xl_grow(self, value: u16) -> Self

Grow factor applied only at Xl breakpoint (>= 160 cols).

pub fn grow_at(self, bp: Breakpoint, value: u16) -> Self

pub fn xs_p(self, value: u32) -> Self

Uniform padding applied only at Xs breakpoint (< 40 cols).

pub fn sm_p(self, value: u32) -> Self

Uniform padding applied only at Sm breakpoint (40-79 cols).

pub fn md_p(self, value: u32) -> Self

Uniform padding applied only at Md breakpoint (80-119 cols).

pub fn lg_p(self, value: u32) -> Self

Uniform padding applied only at Lg breakpoint (120-159 cols).

pub fn xl_p(self, value: u32) -> Self

Uniform padding applied only at Xl breakpoint (>= 160 cols).

pub fn p_at(self, bp: Breakpoint, value: u32) -> Self

pub fn align(self, align: Align) -> Self

Set the cross-axis alignment of child elements.

pub fn center(self) -> Self

Center children on the cross axis. Shorthand for .align(Align::Center).

pub fn justify(self, justify: Justify) -> Self

Set the main-axis content distribution mode.

pub fn space_between(self) -> Self

Distribute children with equal space between; first at start, last at end.

pub fn space_around(self) -> Self

Distribute children with equal space around each child.

pub fn space_evenly(self) -> Self

Distribute children with equal space between all children and edges.

pub fn title(self, title: impl Into<String>) -> Self

Set a plain-text title rendered in the top border.

pub fn title_styled(self, title: impl Into<String>, style: Style) -> Self

Set a styled title rendered in the top border.

pub fn scroll_offset(self, offset: u32) -> Self

Set the vertical scroll offset in rows. Used internally by Context::scrollable.

pub fn col(self, f: impl FnOnce(&mut Context)) -> Response

Finalize the builder as a vertical (column) container.

The closure receives a &mut Context for rendering children. Returns a Response with click/hover state for this container.

pub fn row(self, f: impl FnOnce(&mut Context)) -> Response

Finalize the builder as a horizontal (row) container.

The closure receives a &mut Context for rendering children. Returns a Response with click/hover state for this container.

pub fn line(self, f: impl FnOnce(&mut Context)) -> Response

Finalize the builder as an inline text line.

Like row but gap is forced to zero for seamless inline rendering of mixed-style text.

pub fn draw(self, f: impl FnOnce(&mut Buffer, Rect) + 'static)

Finalize the builder as a raw-draw region with direct buffer access.

The closure receives (&mut Buffer, Rect) after layout is computed. Use buf.set_char(), buf.set_string(), buf.get_mut() to write directly into the terminal buffer. Writes outside rect are clipped.

The closure must be 'static because it is deferred until after layout. To capture local data, clone or move it into the closure:

let data = my_vec.clone();
ui.container().w(40).h(20).draw(move |buf, rect| {
    // use `data` here
});