Struct Dialog

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

A modal confirmation overlay with controlled, bound, or internal visibility.

Confirm activation runs the confirm action and requests close. Cancel-button, backdrop, and Escape activation run the cancel action and request close. In controlled mode, close cannot mutate the supplied binding; the consumer must update it. Bound mode writes false, and internal mode updates retained state. Disabled state hides the dialog without changing visibility state. The optional child remains the underlying host content.

§Examples

use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().title("Unsaved changes?").default_open(true);
let _ = dialog;

Implementations§

Source§

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

Source

pub fn new() -> Self

Creates a closed, enabled, internally managed neutral dialog.

Default labels are "Dialog", "Confirm", and "Cancel"; body text is empty and no actions or host child are installed.

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

pub fn open(self, open: impl Into<Binding<bool>>) -> Self

Sets controlled static or reactive visibility.

This clears writable bound mode. Confirm/cancel still run and consume their input, but the dialog remains open until the external source reads false.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().open(true);
let _ = dialog;
Source

pub fn bind_open(self, open: impl Into<Signal<bool>>) -> Self

Installs a writable visibility signal for two-way close behavior.

Confirm, cancel, backdrop, and Escape paths set the signal to false. A later Self::open call returns to controlled mode.

§Examples
use std::{cell::RefCell, rc::Rc};
use ailloli_ui_runtime::component::Signal;
use ailloli_ui_widgets::controls::Dialog;
let open = Signal::new(Rc::new(RefCell::new(true)), Rc::new(|| {}));
let dialog: Dialog<()> = Dialog::new().bind_open(open);
let _ = dialog;
Source

pub fn default_open(self, open: bool) -> Self

Sets initial retained visibility for internal mode.

This value is ignored when Self::open or Self::bind_open supplies external visibility. It initializes state during first component build; it is not a recurring reopen command.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().default_open(true);
let _ = dialog;
Source

pub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self

Sets a static or reactive disabled binding.

Disabled state hides overlay paint/hit bounds, ignores events, and removes focusability without closing or resetting visibility state.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().open(true).disabled(true);
let _ = dialog;
Source

pub fn title(self, title: impl Into<Binding<String>>) -> Self

Replaces static or reactive title text.

Empty text is valid and paints no glyphs while retaining title geometry.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().title("Delete project?");
let _ = dialog;
Source

pub fn body(self, body: impl Into<Binding<String>>) -> Self

Replaces static or reactive wrapping body text.

Empty body reserves one nominal line; any non-empty body reserves two nominal lines before layout constraints, independently of actual wraps.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().body("This operation cannot be undone.");
let _ = dialog;
Source

pub fn confirm_label(self, label: impl Into<Binding<String>>) -> Self

Replaces static or reactive confirm-button text.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().confirm_label("Delete");
let _ = dialog;
Source

pub fn cancel_label(self, label: impl Into<Binding<String>>) -> Self

Replaces static or reactive cancel-button text.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog: Dialog<()> = Dialog::new().cancel_label("Keep editing");
let _ = dialog;
Source

pub fn tone(self, tone: DialogTone) -> Self

Sets semantic tone and replaces the complete style from the default theme.

This discards custom style values installed earlier.

§Examples
use ailloli_ui_widgets::controls::{Dialog, DialogTone};
let dialog: Dialog<()> = Dialog::new().tone(DialogTone::Danger);
let _ = dialog;
Source

pub fn dialog_style(self, style: DialogStyle) -> Self

Replaces the complete resolved style without changing semantic tone.

A later Self::tone call replaces this custom style. Geometry values are otherwise accepted as-is.

§Examples
use ailloli_ui_core::Theme;
use ailloli_ui_widgets::controls::{Dialog, DialogStyle, DialogTone};
let style = DialogStyle::from_theme(Theme::dark(), DialogTone::Neutral);
let dialog: Dialog<()> = Dialog::new().dialog_style(style);
let _ = dialog;
Source

pub fn on_confirm(self, action: impl IntoClickAction<A>) -> Self

Installs an action run before a confirm close request.

A later call replaces it. Clicking confirm closes even without an action. Keyboard Enter does not currently synthesize confirmation.

§Examples
use ailloli_ui_widgets::controls::Dialog;
#[derive(Clone)]
enum Action { Confirm }
let dialog = Dialog::new().on_confirm(Action::Confirm);
let _ = dialog;
Source

pub fn on_cancel(self, action: impl IntoClickAction<A>) -> Self

Installs an action run before cancellation closes are requested.

The action covers cancel-button, backdrop, and Escape paths. A later call replaces it; cancellation closes even without an action.

§Examples
use ailloli_ui_widgets::controls::Dialog;
#[derive(Clone)]
enum Action { Cancel }
let dialog = Dialog::new().on_cancel(Action::Cancel);
let _ = dialog;
Source

pub fn on_submit(self, action: impl IntoClickAction<A>) -> Self

Installs the action invoked by a non-repeated Enter key in composed modal content.

Descendants receive the event first; a descendant which consumes Enter prevents this fallback submission. The fixed confirmation surface keeps its historical pointer-only confirmation behavior.

§Examples
use ailloli_ui_widgets::controls::Dialog;
let dialog = Dialog::new().on_submit(());
let _ = dialog;
Source

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

Replaces the fixed confirmation panel with retained, declarative modal content.

The content is mounted in a full-viewport retained overlay and may freely compose Text, TextInput, Button, ScrollView, and layout widgets. The host child set by Self::child remains mounted below the modal.

§Examples
use ailloli_ui_widgets::{controls::Dialog, text::Text};
let dialog = Dialog::<()>::new().modal_content(Text::new("Settings"));
let _ = dialog;
Source

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

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

The child fills the resolved host slot and remains painted while the dialog overlay is open.

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

Trait Implementations§

Source§

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

Source§

fn default() -> Self

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

impl<A: 'static> IntoView<A> for Dialog<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 Dialog<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 Dialog<A>

§

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

§

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

§

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

§

impl<A> Unpin for Dialog<A>

§

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