Struct Row

pub struct Row<Msg: Clone> {
    pub children: Vec<Element<Msg>>,
    pub spacing: Length,
    pub padding: Length,
    pub align_right: bool,
}

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()

Fields

children: Vec<Element<Msg>>

spacing: Length

Horizontal gap between children. Length; default 8.0 px.

padding: Length

Padding on all sides. Length; default 0.0 px.

align_right: bool

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 align_right(self) -> Self

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

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.