Struct ToastHost

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

A full-slot host that overlays a stack of toasts over one optional child.

The host itself is never focusable. Close activation is pointer-only and checks visible values in reverse order. Bound mode removes all matching IDs; controlled/static mode reports dismissal but cannot mutate its source. Toasts are not clipped or virtualized and may extend outside a small host.

§Examples

use ailloli_ui_widgets::controls::{Toast, ToastHost};
let host: ToastHost<()> = ToastHost::new().toast(Toast::new("saved", "Saved"));
let _ = host;

Implementations§

Source§

impl<A: 'static> ToastHost<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> ToastHost<A>

Source

pub fn new() -> Self

Creates an empty top-right host with no child or dismissal callback.

§Examples
use ailloli_ui_widgets::controls::ToastHost;
let host: ToastHost<()> = ToastHost::new();
let _ = host;
Source

pub fn toast(self, toast: Toast) -> Self

Appends one toast to a snapshot of the current binding.

This converts the result to static mode and clears a writable binding. Repeated calls preserve order and grow an unbounded vector.

§Examples
use ailloli_ui_widgets::controls::{Toast, ToastHost};
let host: ToastHost<()> = ToastHost::new().toast(Toast::new("one", "First"));
let _ = host;
Source

pub fn toasts(self, toasts: impl Into<Binding<Vec<Toast>>>) -> Self

Replaces the static or reactive controlled toast list.

This clears bound mode, so close activation cannot mutate the source. The callback can be used to ask the consumer to update it.

§Examples
use ailloli_ui_widgets::controls::{Toast, ToastHost};
let host: ToastHost<()> = ToastHost::new().toasts(vec![Toast::new("one", "First")]);
let _ = host;
Source

pub fn bind_toasts(self, toasts: impl Into<Signal<Vec<Toast>>>) -> Self

Installs a writable signal for two-way dismissal.

Close activation removes every toast whose ID equals the activated ID, then invokes the optional callback once.

§Examples
use std::{cell::RefCell, rc::Rc};
use ailloli_ui_runtime::component::Signal;
use ailloli_ui_widgets::controls::{Toast, ToastHost};
let toasts = Signal::new(Rc::new(RefCell::new(vec![Toast::new("one", "First")])), Rc::new(|| {}));
let host: ToastHost<()> = ToastHost::new().bind_toasts(toasts);
let _ = host;
Source

pub fn position(self, position: ToastPosition) -> Self

Selects the corner and vertical stacking direction.

§Examples
use ailloli_ui_widgets::controls::{ToastHost, ToastPosition};
let host: ToastHost<()> = ToastHost::new().position(ToastPosition::BottomLeft);
let _ = host;
Source

pub fn toast_style(self, style: ToastStyle) -> Self

Replaces complete toast-stack style and geometry.

§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::controls::{ToastHost, ToastStyle};
let style = ToastStyle::from_theme(Theme::dark());
let host: ToastHost<()> = ToastHost::new().toast_style(style);
let _ = host;
Source

pub fn on_dismiss(self, f: impl Fn(String) -> A + 'static) -> Self

Maps each dismissed ID to an application action and dispatches it.

The mapper runs after bound values are removed. A later handler replaces it.

§Examples
use ailloli_ui_widgets::controls::ToastHost;
enum Action { Dismissed(String) }
let host = ToastHost::new().on_dismiss(Action::Dismissed);
let _ = host;
Source

pub fn on_dismiss_ctx( self, f: impl Fn(&mut EventCtx<A>, String) + 'static, ) -> Self

Installs a context-aware dismissal callback.

§Examples
use ailloli_ui_widgets::controls::ToastHost;
let host = ToastHost::<()>::new().on_dismiss_ctx(|ctx, _id| ctx.request_repaint());
let _ = host;
Source

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

Sets the sole underlying host child, replacing any previous child.

§Examples
use ailloli_ui_widgets::controls::ToastHost;
use ailloli_ui_widgets::text::Text;
let host = ToastHost::<()>::new().child(Text::new("Workspace"));
let _ = host;

Trait Implementations§

Source§

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

Source§

fn default() -> Self

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

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

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 ToastHost<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 ToastHost<A>

§

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

§

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

§

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

§

impl<A> Unpin for ToastHost<A>

§

impl<A = ()> !UnwindSafe for ToastHost<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,