Struct WrapGrid

pub struct WrapGrid<Msg: Clone> {
    pub children: Vec<Element<Msg>>,
    pub columns: usize,
    pub spacing_x: Length,
    pub spacing_y: Length,
    pub padding: Length,
    pub centre_last_row: bool,
}

A grid layout that wraps children into rows of a fixed column count.

All cells in a row share the same height (the tallest item in that row). Column widths are equal, dividing the available width minus padding and spacing.

Designed for app-drawer style layouts — combine with scroll() for vertically scrollable grids:

scroll(
    grid( 4 )
        .padding( 16.0 )
        .spacing( 12.0 )
        .push( icon_button( data.clone(), w, h ).on_press( Msg::Open( 0 ) ) )
        .push( icon_button( data, w, h ).on_press( Msg::Open( 1 ) ) )
        // ...
)
.into()

Fields

children: Vec<Element<Msg>>

Child widgets laid out in row-major order.

columns: usize

Number of columns per row.

spacing_x: Length

Horizontal gap between cells.

spacing_y: Length

Vertical gap between rows.

padding: Length

Padding on all sides.

centre_last_row: bool

When true, a partial last row is centred horizontally within the grid’s content rect instead of being left-aligned.

Implementations

impl<Msg: Clone> WrapGrid<Msg>

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

Append a child widget to the grid.

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

Set both horizontal and vertical gap between cells (default 8.0).

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

Set only the horizontal gap between cells; leaves vertical spacing untouched.

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

Set only the vertical gap between rows; leaves horizontal spacing untouched.

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

Set the padding on all sides (default 0.0).

pub fn centre_last_row(self, yes: bool) -> Self

Centre a partial last row horizontally inside the content rect. Default is false (left-aligned, like other grids).

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

Compute the preferred size given an available width.

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

Compute child rects. Returns (child_rect, index_in_children) pairs.

Trait Implementations

impl<Msg: Clone + 'static> From<WrapGrid<Msg>> for Element<Msg>

fn from(g: WrapGrid<Msg>) -> Self

Converts to this type from the input type.