Struct DialogView 

pub struct DialogView<State: 'static> { /* private fields */ }

A declarative basic M3 dialog: a centered panel over the host’s scrim. See the module docs.

Implementations

impl<State: 'static> DialogView<State>

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

Set the dialog title (headlineSmallEmphasized, onSurface).

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

Set the dialog supporting text (bodyMedium, onSurfaceVariant).

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

Replace the trailing action row with actions (app-provided buttons, in reading order — the last one sits closest to the trailing edge).

pub fn action(self, action: impl View<State>) -> Self

Append one action button to the trailing action row.

pub fn dismissable(self, dismissable: bool) -> Self

Whether the user can dismiss this dialog at all — the scrim tap, Escape, and an Android back press (default true; see crate::overlay::modal::OverlayModalView::dismissable). false disables all three; only an app-provided action still dismisses it.

pub fn on_dismiss<F: Fn(&mut State) + 'static>(self, on_dismiss: F) -> Self

Observe a scrim-tap/Escape/back dismissal. show_dialog already wires the pop for you (via OverlayModalContent::on_modal_dismiss); this is for a caller that wants to react to it too (or that mounts a DialogView directly in a Stack, with no navigator involved).

pub fn dismiss_handle(self, dismiss: ModalDismiss) -> Self

Install the app-triggered staged-dismiss handle, so a Cancel/Confirm action closes the dialog through the same exit ramp the scrim tap, Escape, and a back press take — rather than a raw controller.pop(), which dismisses on the spot with no ramp. See ModalDismiss; mint the handle outside show_dialog’s page builder.

Trait Implementations

impl<State: 'static> OverlayModalContent<State> for DialogView<State>

fn on_modal_dismiss(self, on_dismiss: Rc<dyn Fn(&mut State)>) -> Self

Install the dismiss callback, replacing any the builder already set.

fn modal_dismissable(&self) -> bool

Whether this modal may be dismissed by the user at all — read once, at push time, to pick the page’s BackPolicy.

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

type Element = OverlayModalWidget

The retained widget this view produces.

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

Materialise a fresh widget for this view.

fn rebuild( &self, prev: &Self, element: &mut OverlayModalWidget, 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.

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

Tear down element when this view is being removed.

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

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