Struct Column

pub struct Column<Msg: Clone> {
    pub children: Vec<Element<Msg>>,
    pub spacing: Length,
    pub padding: Length,
    pub align_center_x: bool,
    pub center_y: bool,
    pub max_width: Option<Length>,
    pub fit_content: bool,
}

A vertical layout container.

Children are arranged top-to-bottom with optional spacing and padding. Spacers absorb remaining vertical space, enabling push-to-bottom layouts.

column()
    .padding( 24.0 )
    .spacing( 12.0 )
    .push( text( "Title" ) )
    .push( spacer() )
    .push( button( "OK" ).on_press( Msg::Ok ) )
.into()

padding, spacing and max_width all accept any crate::Length, so a responsive layout reads as:

column()
    // Padding is 3 % of the viewport's smaller side, clamped to 16..48 px.
    .padding( Length::vmin( 3.0 ).clamp( 16.0, 48.0 ) )
    .spacing( Length::vmin( 1.5 ).at_least( 8.0 ) )
    .max_width( Length::vw( 60.0 ).at_most( 720.0 ) )
    .push( text( "Responsive" ) )
    .push( button( "OK" ).on_press( Msg::Ok ) )
.into()

Fields

children: Vec<Element<Msg>>

spacing: Length

Vertical gap between children. Stored as Length so a Vmin(2.0) or Em(0.5) gap scales with the viewport instead of freezing at a px constant.

padding: Length

Padding on all sides. Same Length semantics as spacing.

align_center_x: bool

center_y: bool

max_width: Option<Length>

fit_content: bool

Implementations

impl<Msg: Clone> Column<Msg>

pub fn new() -> Self

pub fn push(self, e: impl Into<Element<Msg>>) -> Self

Append a child widget or layout.

pub fn spacing(self, s: impl Into<Length>) -> Self

Set the vertical gap between children. Default: 8.0 px. Accepts any Length — pass an f32 for the px case, or a relative value like Length::vmin( 2.0 ) to scale with the viewport.

pub fn padding(self, p: impl Into<Length>) -> Self

Set the padding (all sides). Default: 16.0 px. Accepts any Length.

pub fn align_center_x(self, c: bool) -> Self

When true (default), children are centered horizontally.

pub fn center_y(self, c: bool) -> Self

When true, center the content block vertically (only when no spacers are present).

pub fn max_width(self, w: impl Into<Length>) -> Self

Limit the content width. Accepts any Length. The column still reports the parent’s max_width as its preferred width so the parent allocates the full available rect.

pub fn fit_content(self) -> Self

Report the intrinsic content width as preferred width instead of filling the available max_width. Use this when the column represents a card or widget meant to sit side-by-side with other children inside a Row — without this flag, two columns in a row each claim the full row width and overflow their siblings.

The preferred width is computed as the max of children’s preferred widths plus padding, capped by the external max_width the parent offers and by any max_width setting on the column itself.

pub fn preferred_size(&self, max_width: f32, canvas: &Canvas) -> (f32, f32)

Return the preferred (width, height) given available max_width.

pub fn draw(&self, _canvas: &mut Canvas, _rect: Rect, _focused: bool)

pub fn layout(&self, rect: Rect, canvas: &Canvas) -> Vec<(Rect, usize)>

Layout children within rect and return (rect, child_index) pairs.

Trait Implementations

impl<Msg: Clone> Default for Column<Msg>

fn default() -> Self

Returns the “default value” for a type.

impl<Msg: Clone> From<Column<Msg>> for Element<Msg>

fn from(c: Column<Msg>) -> Self

Converts to this type from the input type.