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>
impl<A: 'static> Dialog<A>
Sourcepub fn height(self, value: impl Into<Length>) -> Self
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;Sourcepub fn min_width(self, value: impl Into<Length>) -> Self
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;Sourcepub fn max_width(self, value: impl Into<Length>) -> Self
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;Sourcepub fn min_height(self, value: impl Into<Length>) -> Self
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;Sourcepub fn max_height(self, value: impl Into<Length>) -> Self
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;Sourcepub fn fill(self) -> Self
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;Sourcepub fn fill_width(self) -> Self
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;Sourcepub fn fill_height(self) -> Self
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;Sourcepub fn margin(self, value: f32) -> Self
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;Sourcepub fn padding(self, value: f32) -> Self
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;Sourcepub fn flex_grow(self) -> Self
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;Sourcepub fn flex_grow_by(self, value: f32) -> Self
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;Sourcepub fn flex_shrink(self, value: f32) -> Self
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;Sourcepub fn flex_basis(self, value: impl Into<Length>) -> Self
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;Sourcepub fn align_self(self, value: AlignItems) -> Self
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>
impl<A: 'static> Dialog<A>
Sourcepub fn new() -> Self
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;Sourcepub fn open(self, open: impl Into<Binding<bool>>) -> Self
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;Sourcepub fn bind_open(self, open: impl Into<Signal<bool>>) -> Self
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;Sourcepub fn default_open(self, open: bool) -> Self
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;Sourcepub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
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;Sourcepub fn title(self, title: impl Into<Binding<String>>) -> Self
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;Sourcepub fn body(self, body: impl Into<Binding<String>>) -> Self
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;Sourcepub fn confirm_label(self, label: impl Into<Binding<String>>) -> Self
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;Sourcepub fn cancel_label(self, label: impl Into<Binding<String>>) -> Self
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;Sourcepub fn tone(self, tone: DialogTone) -> Self
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;Sourcepub fn dialog_style(self, style: DialogStyle) -> Self
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;Sourcepub fn on_confirm(self, action: impl IntoClickAction<A>) -> Self
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;Sourcepub fn on_cancel(self, action: impl IntoClickAction<A>) -> Self
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;Sourcepub fn on_submit(self, action: impl IntoClickAction<A>) -> Self
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;Sourcepub fn modal_content(self, content: impl IntoView<A>) -> Self
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;Sourcepub fn child(self, child: impl IntoView<A>) -> Self
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;