Skip to main content

Container

Struct Container 

Source
pub struct Container {
Show 16 fields pub id: Option<NodeId>, pub child: Option<Box<Node>>, 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 background_color: Option<Color>, pub border_color: Option<Color>, pub border_width: f32, pub border_radius: f32, pub shadow: Option<BoxShadow>,
}
Expand description

The universal wrapper widget: background colour, 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").into_node())
    .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<NodeId>

Explicit node identity.

§child: Option<Box<Node>>

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

§background_color: Option<Color>

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.

Implementations§

Source§

impl Container

Source

pub fn new(child: Node) -> Self

Source

pub fn id(self, id: NodeId) -> Self

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

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

Source

pub fn into_node(self) -> Node

Trait Implementations§

Source§

impl Clone for Container

Source§

fn clone(&self) -> Container

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Container

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Container

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

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

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl From<Container> for Node

Source§

fn from(w: Container) -> Self

Converts to this type from the input type.
Source§

impl Lower for Container

Source§

fn lower(&self, cx: &mut LoweringContext<'_>) -> NodeId

Lower this widget into the IR, returning the root node id.
Source§

impl Serialize for Container

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl<S: AppState> Widget<S> for Container

Source§

fn build(&self, _ctx: &mut BuildCtx<S>, _view: &View<'_, S>) -> Node

Build the widget’s node tree. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,