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: typed box layout, background fill, border, padding, margin, overflow, aspect ratio, positioning, and shadow on one child.

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

Example

const CARD_MIN_WIDTH: f32 = 280.0;
const CARD_MAX_WIDTH: f32 = 520.0;

Container::new(Text::new("Card body"))
    .bg(theme.tokens.colors.surface)
    .border(theme.tokens.colors.border, 1.0)
    .border_radius(theme.tokens.radii.large)
    .padding_lengths(Length::all(Length::points(theme.tokens.spacing.l)))
    .width_length(Length::clamp(
        Length::points(CARD_MIN_WIDTH),
        Length::percent(42.0),
        Length::points(CARD_MAX_WIDTH),
    ))
    .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.