Struct Container 

pub struct Container {

    pub id: Option<WidgetId>,
    pub child: Option<Widget>,
    pub width: Option<f32>,
    pub height: Option<f32>,
    pub min_width: Option<f32>,
    pub max_width: Option<f32>,
    pub min_height: Option<f32>,
    pub max_height: Option<f32>,
    pub padding: [f32; 4],
    pub flex_grow: f32,
    pub flex_shrink: f32,
    pub box_style: BoxStyle,
    pub margin: [f32; 4],
    pub background_fill: Option<Fill>,
    pub background_color: Option<Color>,
    pub border_color: Option<Color>,
    pub border_width: f32,
    pub border_radius: f32,
    pub shadow: Option<BoxShadow>,
    pub shadows: Vec<BoxShadow>,
    pub backdrop_filter: Option<BackdropFilter>,
}

The universal wrapper widget: background fill, border, padding, size constraints, and box shadow on a single child.

Container is the workhorse of layout composition. Use it whenever you need to add visual decoration or spacing around a child widget.

Example

Container::new(Text::new("Card body"))
    .bg(theme.tokens.colors.surface)
    .border(theme.tokens.colors.border, 1.0)
    .border_radius(8.0)
    .padding_all(16.0)
    .width(320.0)
    .flex_grow(1.0)

Fields

id: Option<WidgetId>

Explicit node identity.

child: Option<Widget>

The single child widget.

width: Option<f32>

Fixed width in layout points.

height: Option<f32>

Fixed height in layout points.

min_width: Option<f32>

Minimum width constraint.

max_width: Option<f32>

Maximum width constraint.

min_height: Option<f32>

Minimum height constraint.

max_height: Option<f32>

Maximum height constraint.

padding: [f32; 4]

Padding [left, right, top, bottom].

flex_grow: f32

Flex grow factor (how much extra space this container absorbs).

flex_shrink: f32

Flex shrink factor (how much this container shrinks when space is tight).

box_style: BoxStyle

Declarative sizing, padding, aspect ratio, and overflow.

margin: [f32; 4]

Outer spacing [left, right, top, bottom].

background_fill: Option<Fill>

Background fill.

background_color: Option<Color>

Legacy background fill colour.

border_color: Option<Color>

Border stroke colour.

border_width: f32

Border stroke width in layout points.

border_radius: f32

Corner radius for rounded corners.

shadow: Option<BoxShadow>

Optional drop shadow.

shadows: Vec<BoxShadow>

Additional shadows drawn behind the container in order.

backdrop_filter: Option<BackdropFilter>

Filter applied to content painted behind this container.

Implementations

impl Container

pub fn new(child: impl Into<Widget>) -> Self

pub fn size(self, w: f32, h: f32) -> Self

pub fn width(self, w: f32) -> Self

pub fn width_length(self, width: Length) -> Self

Sets a typed preferred width.

pub fn height_length(self, height: Length) -> Self

Sets a typed preferred height.

pub fn min_width_length(self, width: Length) -> Self

Sets a typed minimum width.

pub fn max_width_length(self, width: Length) -> Self

Sets a typed maximum width.

pub fn min_height_length(self, height: Length) -> Self

Sets a typed minimum height.

pub fn max_height_length(self, height: Length) -> Self

Sets a typed maximum height.

pub fn height(self, h: f32) -> Self

pub fn min_width(self, w: f32) -> Self

pub fn max_width(self, w: f32) -> Self

pub fn min_height(self, h: f32) -> Self

pub fn max_height(self, h: f32) -> Self

pub fn padding_all(self, p: f32) -> Self

pub fn padding(self, padding: [f32; 4]) -> Self

pub fn padding_lengths(self, padding: [Length; 4]) -> Self

Sets typed [left, right, top, bottom] padding.

pub fn margin_all(self, margin: f32) -> Self

Sets equal point-based margin on every edge.

pub fn margin(self, margin: [f32; 4]) -> Self

Sets point-based [left, right, top, bottom] margin.

pub fn margin_lengths(self, margin: [Length; 4]) -> Self

Sets typed [left, right, top, bottom] margin.

pub fn align_child(self, alignment: BoxAlignment) -> Self

Aligns the child inside this container.

pub fn aspect_ratio(self, ratio: f32) -> Self

Sets a non-negative width-to-height ratio.

pub fn positioned( self, left: Option<f32>, top: Option<f32>, right: Option<f32>, bottom: Option<f32>, ) -> Self

Absolutely positions this container with point-based offsets.

pub fn positioned_lengths( self, left: Option<Length>, top: Option<Length>, right: Option<Length>, bottom: Option<Length>, ) -> Self

Positions this box with typed offsets relative to its positioned ancestor.

pub fn grid_cell(self, row: i16, column: i16) -> Self

Places this container at a one-based grid row and column.

pub fn grid_span(self, rows: u16, columns: u16) -> Self

Spans this container across parent grid rows and columns.

pub fn clip_overflow(self, clip: bool) -> Self

Clips painting and descendants to this container’s bounds.

pub fn flex_grow(self, grow: f32) -> Self

pub fn flex_shrink(self, shrink: f32) -> Self

pub fn bg(self, color: Color) -> Self

pub fn bg_fill(self, fill: Fill) -> Self

pub fn border(self, color: Color, width: f32) -> Self

pub fn border_radius(self, radius: f32) -> Self

pub fn shadow(self, shadow: BoxShadow) -> Self

pub fn shadows(self, shadows: Vec<BoxShadow>) -> Self

pub fn backdrop_blur(self, sigma: f32) -> Self

Blurs content behind this container, clipped to its rounded bounds.

Trait Implementations

impl Clone for Container

fn clone(&self) -> Container

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Container

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Container

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Container

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Container> for Widget

fn from(w: Container) -> Self

Converts to this type from the input type.

impl Serialize for Container

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.