Trait FlexItemExt

Source
pub trait FlexItemExt<A>: IntoView<A> + Sized {
    // Provided methods
    fn flex_grow(self) -> View<A> { ... }
    fn flex_grow_by(self, value: f32) -> View<A> { ... }
    fn flex_shrink(self, value: f32) -> View<A> { ... }
    fn flex_basis(self, value: impl Into<Length>) -> View<A> { ... }
    fn align_self(self, value: AlignItems) -> View<A> { ... }
    fn fill_width(self) -> View<A> { ... }
    fn fill_height(self) -> View<A> { ... }
    fn fill(self) -> View<A> { ... }
}
Expand description

Flex-item builders returning a [View] for already-built views/components.

These methods replace one metadata field and preserve the retained subtree. Numeric grow/shrink values are stored according to [FlexItemStyle]’s normalization rules.

§Examples

use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let base: View<()> = Text::new("grow").into_view();
let grown: View<()> = base.flex_grow();
assert_eq!(grown.flex_item.flex_grow, 1.0);

Provided Methods§

Source

fn flex_grow(self) -> View<A>

Sets flex-grow weight to one.

§Examples
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("grow").into_view().flex_grow();
assert_eq!(view.flex_item.flex_grow, 1.0);
Source

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

Sets the dimensionless flex-grow weight.

§Examples
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("grow").into_view().flex_grow_by(3.0);
assert_eq!(view.flex_item.flex_grow, 3.0);
Source

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

Sets the dimensionless flex-shrink weight.

§Examples
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("shrink").into_view().flex_shrink(2.0);
assert_eq!(view.flex_item.flex_shrink, 2.0);
Source

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

Sets the preferred main-axis flex basis.

§Examples
use ailloli_ui_core::style::Length;
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("basis").into_view().flex_basis(40.0);
assert_eq!(view.flex_item.flex_basis, Length::px(40.0));
Source

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

Overrides the parent cross-axis alignment for this view.

§Examples
use ailloli_ui_core::style::AlignItems;
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("end").into_view().align_self(AlignItems::End);
assert_eq!(view.flex_item.align_self, Some(AlignItems::End));
Source

fn fill_width(self) -> View<A>

Marks width as parent-fill in the view size hint.

§Examples
use ailloli_ui_core::style::Length;
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("wide").into_view().fill_width();
assert_eq!(view.size_hint.width, Length::Fill);
Source

fn fill_height(self) -> View<A>

Marks height as parent-fill in the view size hint.

§Examples
use ailloli_ui_core::style::Length;
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("tall").into_view().fill_height();
assert_eq!(view.size_hint.height, Length::Fill);
Source

fn fill(self) -> View<A>

Marks both axes as parent-fill in the view size hint.

§Examples
use ailloli_ui_core::style::Length;
use ailloli_ui_runtime::component::{IntoView, View};
use ailloli_ui_widgets::{layout::FlexItemExt, text::Text};
let view: View<()> = Text::new("fill").into_view().fill();
assert_eq!((view.size_hint.width, view.size_hint.height), (Length::Fill, Length::Fill));

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors§

Source§

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