Skip to main content

FlexView

Struct FlexView 

Source
pub struct FlexView<State: 'static> { /* private fields */ }
Expand description

A declarative flex container. See the module docs.

Implementations§

Source§

impl<State: 'static> FlexView<State>

Source

pub fn new(direction: Axis, children: Vec<FlexChild<State>>) -> Self

Create a flex laying children out along direction, cross-aligned to the start and main-aligned to the start.

Source

pub fn child<V: View<State>>(self, view: V) -> Self

Append an inflexible child. Accepts any View; erasure happens internally, so no any() is needed.

Source

pub fn flex<V: View<State>>(self, flex: u32, view: V) -> Self

Append a flexible child taking flex proportional shares of the free main-axis space.

Source

pub fn keyed<V: View<State>>(self, key: impl Into<ChildKey>, view: V) -> Self

Append an inflexible child tagged with a stable ChildKey (see keyed for the reconciliation semantics and the all-or-nothing rule).

Source

pub fn children<M>(self, children: impl ViewSeq<State, M>) -> Self

Append every element of children as an inflexible child.

Accepts any ViewSeq: a Vec/array of views, a tuple of mixed view types, an Option, nested sequences, or views(iter) for an iterator. Tuples are positional: a None element drops its slot and nested sequences flatten in order. For a keyed list use FlexView::keyed per child (the all-or-nothing rule of keyed still applies; a tuple does not carry keys).

Source

pub fn push(self, child: FlexChild<State>) -> Self

Append a pre-built FlexChild (escape hatch for flexible / inflexible / keyed values built elsewhere).

Source

pub fn when(self, cond: bool, f: impl FnOnce(Self) -> Self) -> Self

Apply f to the builder only when cond is true.

Source

pub fn when_some<T>( self, opt: Option<T>, f: impl FnOnce(Self, T) -> Self, ) -> Self

Apply f with the contained value when opt is Some.

Source

pub fn cross_axis(self, cross: CrossAxisAlignment) -> Self

Set the cross-axis alignment.

Source

pub fn main_axis(self, main: MainAxisAlignment) -> Self

Set the main-axis alignment.

Trait Implementations§

Source§

impl<State: 'static> View<State> for FlexView<State>

Source§

type Element = FlexWidget

The retained widget this view produces.
Source§

fn build(&self, ctx: &mut BuildCtx<'_>) -> FlexWidget

Materialise a fresh widget for this view.
Source§

fn rebuild( &self, prev: &Self, element: &mut FlexWidget, ctx: &mut BuildCtx<'_>, ) -> ChangeFlags

Reconcile prev (the previous view of the same type) against the live element, mutating it in place and reporting what changed.
Source§

fn teardown(&self, element: &mut FlexWidget, ctx: &mut BuildCtx<'_>)

Tear down element when this view is being removed. Read more
Source§

fn message(&self, _element: &mut Self::Element, _state: &mut State)

Deliver an event message to this view, mutating application state. Read more

Auto Trait Implementations§

§

impl<State> !RefUnwindSafe for FlexView<State>

§

impl<State> !Send for FlexView<State>

§

impl<State> !Sync for FlexView<State>

§

impl<State> !UnwindSafe for FlexView<State>

§

impl<State> Freeze for FlexView<State>
where Vec<FlexChild<State>>: Freeze,

§

impl<State> Unpin for FlexView<State>
where Vec<FlexChild<State>>: Unpin,

§

impl<State> UnsafeUnpin for FlexView<State>
where Vec<FlexChild<State>>: UnsafeUnpin,

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> ErasedDestructor for T
where T: 'static,

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> StorageAccess<T> for T

Source§

fn as_borrowed(&self) -> &T

Borrows the value.
Source§

fn into_taken(self) -> T

Takes the value.
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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<State, V> ViewSeq<State, One> for V
where State: 'static, V: View<State>,

Source§

fn extend_views(self, out: &mut Vec<AnyView<State>>)

Push every element of this sequence, in order, onto out — erasing each with AnyView::new (a no-op for an element already an AnyView).