Struct Stack

pub struct Stack<Msg: Clone> {
    pub children: Vec<(Element<Msg>, HAlign, VAlign, f32, f32, f32)>,
    pub fit_content: bool,
}

A layout that draws all its children stacked on top of each other. Each child can be positioned within the Stack rect via HAlign/VAlign.

Useful for overlaying a foreground widget on top of a background image:

stack()
    .push( img_widget( bg_rgba, w, h ) )
    .push_aligned( column().push( text( "Bottom right" ) ), HAlign::End, VAlign::Bottom )
.into()

Fields

children: Vec<(Element<Msg>, HAlign, VAlign, f32, f32, f32)>

Children with their alignment, margin, and extra (x, y) translation applied after alignment. Drawn in order — last child is on top.

fit_content: bool

When true, preferred_size reports the max of children’s intrinsic widths and heights instead of (max_width, tallest).

Implementations

impl<Msg: Clone> Stack<Msg>

pub fn new() -> Self

Create an empty stack.

pub fn fit_content(self) -> Self

Enable Self::fit_content.

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

Append a child that fills the entire Stack rect (Android FrameLayout default).

pub fn push_aligned( self, e: impl Into<Element<Msg>>, h_align: HAlign, v_align: VAlign, ) -> Self

Append a child with explicit horizontal and vertical alignment.

pub fn push_aligned_margin( self, e: impl Into<Element<Msg>>, h_align: HAlign, v_align: VAlign, margin: f32, ) -> Self

Append a child with alignment and a uniform margin (inset from the Stack edges).

pub fn push_translated( self, e: impl Into<Element<Msg>>, h_align: HAlign, v_align: VAlign, offset_x: f32, offset_y: f32, ) -> Self

Append a child with alignment plus an extra (x, y) translation in logical pixels. Useful when a child needs to shift outside the normal alignment grid without giving up the margin or alignment shorthand. Positive x / y move the child right / down.

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

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

Return (rect, child_index) pairs, computing each child’s rect from its alignment.

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

No-op — children are drawn directly by the event loop during layout.

Trait Implementations

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

fn default() -> Self

Returns the “default value” for a type.

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

fn from(s: Stack<Msg>) -> Self

Converts to this type from the input type.