Struct Container

Source
pub struct Container<A = ()> { /* private fields */ }
Expand description

Declarative box with background, border, shadows, and optional child clip.

The default is transparent, borderless, shadowless, unclipped, automatically sized, and has no child. Margin surrounds the border box; border and padding surround the content. Only one child is retained.

§Examples

use ailloli_ui_core::Color;
use ailloli_ui_widgets::{layout::Container, text::Text};
let card: Container<()> = Container::new().background(Color::BLACK).padding(8.0).child(Text::new("Body"));
let _ = card;

Implementations§

Source§

impl<A: 'static> Container<A>

Source

pub fn width(self, value: impl Into<Length>) -> Self

Sets preferred width from a logical-pixel or length value.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().width(120.0);
let _ = widget;
Source

pub fn height(self, value: impl Into<Length>) -> Self

Sets preferred height from a logical-pixel or length value.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().height(40.0);
let _ = widget;
Source

pub fn min_width(self, value: impl Into<Length>) -> Self

Sets the minimum width bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_width(40.0);
let _ = widget;
Source

pub fn max_width(self, value: impl Into<Length>) -> Self

Sets the maximum width bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_width(320.0);
let _ = widget;
Source

pub fn min_height(self, value: impl Into<Length>) -> Self

Sets the minimum height bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_height(24.0);
let _ = widget;
Source

pub fn max_height(self, value: impl Into<Length>) -> Self

Sets the maximum height bound.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_height(240.0);
let _ = widget;
Source

pub fn fill(self) -> Self

Sets both preferred axes to parent fill.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill();
let _ = widget;
Source

pub fn fill_width(self) -> Self

Sets preferred width to parent fill.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_width();
let _ = widget;
Source

pub fn fill_height(self) -> Self

Sets preferred height to parent fill.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_height();
let _ = widget;
Source

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

Sets uniform outer margin in logical pixels.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().margin(8.0);
let _ = widget;
Source

pub fn padding(self, value: f32) -> Self

Sets uniform inner padding in logical pixels.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().padding(8.0);
let _ = widget;
Source

pub fn flex_grow(self) -> Self

Sets flex-grow weight to one.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow();
let _ = widget;
Source

pub fn flex_grow_by(self, value: f32) -> Self

Sets a dimensionless flex-grow weight.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow_by(2.0);
let _ = widget;
Source

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

Sets a dimensionless flex-shrink weight.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_shrink(1.0);
let _ = widget;
Source

pub fn flex_basis(self, value: impl Into<Length>) -> Self

Sets the preferred main-axis flex basis.

§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_basis(80.0);
let _ = widget;
Source

pub fn align_self(self, value: AlignItems) -> Self

Overrides cross-axis alignment for this flex item.

§Examples
use ailloli_ui_core::style::AlignItems;
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().align_self(AlignItems::Center);
let _ = widget;
Source§

impl<A: 'static> Container<A>

Source

pub fn new() -> Self

Creates an empty transparent box with automatic layout.

§Examples
use ailloli_ui_widgets::layout::Container;
let container: Container<()> = Container::new();
let _ = container;
Source

pub fn surface(theme: Theme) -> Self

Creates a theme surface with a one-pixel border and large radius.

§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::layout::Container;
let surface: Container<()> = Container::surface(Theme::dark());
let _ = surface;
Source

pub fn panel(theme: Theme) -> Self

Creates an elevated themed surface with the medium theme shadow.

§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::layout::Container;
let panel: Container<()> = Container::panel(Theme::dark());
let _ = panel;
Source

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

Replaces the background with one solid color.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().background(Color::BLACK);
let _ = box_;
Source

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

Sets a uniform logical-pixel corner radius without clamping.

§Examples
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().radius(8.0);
let _ = box_;
Source

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

Replaces all four border widths and colors.

Width normalization follows [Border::new].

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().border(1.0, Color::WHITE);
let _ = box_;
Source

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

Replaces all four widths while preserving edge colors.

§Examples
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().border_width(2.0);
let _ = box_;
Source

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

Replaces all four colors while preserving edge widths.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().border_color(Color::WHITE);
let _ = box_;
Source

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

Replaces only the left border width and color.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().border_left(2.0, Color::WHITE);
let _ = box_;
Source

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

Replaces only the top border width and color.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().border_top(2.0, Color::WHITE);
let _ = box_;
Source

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

Replaces only the right border width and color.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().border_right(2.0, Color::WHITE);
let _ = box_;
Source

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

Replaces only the bottom border width and color.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().border_bottom(2.0, Color::WHITE);
let _ = box_;
Source

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

Appends one shadow; later shadows paint after earlier shadows.

§Examples
use ailloli_ui_core::style::BoxShadow;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().shadow(BoxShadow::md());
let _ = box_;
Source

pub fn shadow_none(self) -> Self

Removes every configured shadow.

§Examples
use ailloli_ui_core::style::BoxShadow;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().shadow(BoxShadow::md()).shadow_none();
let _ = box_;
Source

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

Replaces the last shadow color, inserting a medium shadow if absent.

§Examples
use ailloli_ui_core::Color;
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().shadow_color(Color::BLACK);
let _ = box_;
Source

pub fn shadow_blur(self, value: f32) -> Self

Replaces the last shadow blur radius in logical pixels.

Negative and NaN values resolve to zero; an absent shadow first inserts the medium default.

§Examples
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().shadow_blur(12.0);
let _ = box_;
Source

pub fn shadow_offset(self, x: f32, y: f32) -> Self

Replaces the last shadow offset in logical pixels.

Values are stored without finiteness checks; an absent shadow first inserts the medium default.

§Examples
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().shadow_offset(0.0, 4.0);
let _ = box_;
Source

pub fn shadow_spread(self, value: f32) -> Self

Replaces the last shadow spread in logical pixels.

Negative and NaN values resolve to zero; an absent shadow first inserts the medium default.

§Examples
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().shadow_spread(2.0);
let _ = box_;
Source

pub fn clip_children(self, value: bool) -> Self

Clips children to the inner rect (rounded when radius > 0).

The clip excludes margin, border, and padding. It is disabled by default.

§Examples
use ailloli_ui_widgets::layout::Container;
let box_: Container<()> = Container::new().radius(8.0).clip_children(true);
let _ = box_;
Source

pub fn window_root_clip(self, value: bool) -> Self

Marks this container as the window root clip (Window::radius). Enables window-root stencil heuristics on the GPU path.

This marker is independent of clip_children; callers are responsible for applying it only to the actual root clip.

§Examples
use ailloli_ui_widgets::layout::Container;
let root: Container<()> = Container::new().clip_children(true).window_root_clip(true);
let _ = root;
Source

pub fn child(self, child: impl IntoView<A>) -> Self

Sets the single content child, replacing any previous child.

§Examples
use ailloli_ui_widgets::{layout::Container, text::Text};
let box_: Container<()> = Container::new().child(Text::new("content"));
let _ = box_;

Trait Implementations§

Source§

impl<A: 'static> Default for Container<A>

Creates the same empty transparent box as Container::new.

Source§

fn default() -> Self

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

impl<A: 'static> IntoView<A> for Container<A>

Converts the builder into one retained box node and optional child.

Source§

fn into_view(self) -> View<A>

Consumes a builder/value and returns its declarative view tree. Read more
Source§

impl<A: 'static> LayoutExt for Container<A>

Source§

fn layout_mut(&mut self) -> &mut LayoutStyle

Returns the widget’s mutable declarative size/inset state. Read more

Auto Trait Implementations§

§

impl<A> Freeze for Container<A>

§

impl<A = ()> !RefUnwindSafe for Container<A>

§

impl<A = ()> !Send for Container<A>

§

impl<A = ()> !Sync for Container<A>

§

impl<A> Unpin for Container<A>

§

impl<A = ()> !UnwindSafe for Container<A>

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, A> FlexItemExt<A> for T
where T: IntoView<A>,

Source§

fn flex_grow(self) -> View<A>

Sets flex-grow weight to one. Read more
Source§

fn flex_grow_by(self, value: f32) -> View<A>

Sets the dimensionless flex-grow weight. Read more
Source§

fn flex_shrink(self, value: f32) -> View<A>

Sets the dimensionless flex-shrink weight. Read more
Source§

fn flex_basis(self, value: impl Into<Length>) -> View<A>

Sets the preferred main-axis flex basis. Read more
Source§

fn align_self(self, value: AlignItems) -> View<A>

Overrides the parent cross-axis alignment for this view. Read more
Source§

fn fill_width(self) -> View<A>

Marks width as parent-fill in the view size hint. Read more
Source§

fn fill_height(self) -> View<A>

Marks height as parent-fill in the view size hint. Read more
Source§

fn fill(self) -> View<A>

Marks both axes as parent-fill in the view size hint. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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.

§

impl<T, A> IntoViewKeyExt<A> for T
where T: IntoView<A>,

§

fn key(self, key: impl Into<String>) -> View<A>

Converts self, assigns the owned key, and returns the view. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
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.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,