Struct Row

pub struct Row<Msg: Clone> { /* private fields */ }

A horizontal layout container.

Children are arranged left-to-right. Use Row::align_right to push the content block to the right edge of the available width.

row()
    .spacing( 16.0 )
    .align_right()
    .push( icon_button( a_rgba, w, h ).on_press( Msg::A ) )
    .push( icon_button( b_rgba, w, h ).on_press( Msg::B ) )
.into()

spacing and padding accept any crate::Length:

row()
    // 2 % of the viewport's smaller side, never below 8 px.
    .spacing( Length::vmin( 2.0 ).at_least( 8.0 ) )
    .push( icon_button( a_rgba, w, h ).on_press( Msg::A ) )
    .push( icon_button( b_rgba, w, h ).on_press( Msg::B ) )
.into()

Implementations

impl<Msg: Clone> Row<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 horizontal gap between children. Default: 8.0 px. Accepts any Length so the gap can scale with the viewport.

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

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

pub fn no_shrink(self) -> Self

Keep every child at its preferred width even when the cluster does not fit, letting it overflow the row’s rect.

The default distributes the shortfall instead, which is what a row of labelled buttons wants. Opt out for strips that are deliberately wider than their viewport — a carousel rail, a tray meant to be scrolled — where shrinking to fit would defeat the point.

pub fn align_right(self) -> Self

Push the content block to the right edge of the available width.

pub fn align_top(self) -> Self

Pin children to the top edge instead of the default vertical centering, so siblings of slightly different heights (e.g. two cards whose text metrics differ) share the same top line.

pub fn fill_height(self) -> Self

Stretch every child to the row’s inner height, so siblings share both the top and the bottom line regardless of their natural heights. The row’s own height still comes from the tallest child’s preferred size; children whose content should track the stretch need internal flexible spacers.

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.

Flexible Spacer children claim the leftover horizontal space: non-spacer widgets keep their preferred width, the remaining width (after subtracting spacing + padding) is distributed between spacers in proportion to their weight. When no spacers are present the cluster is centered (or right-aligned via Row::align_right).

Trait Implementations

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

fn default() -> Self

Returns the “default value” for a type.

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

fn from(r: Row<Msg>) -> Self

Converts to this type from the input type.