Struct InputDialog 

pub struct InputDialog { /* private fields */ }

A single-field input modal.

Implementations

impl InputDialog

pub fn new(title: impl Into<LocalizedString>) -> Self

Construct a new input dialog with the given title.

pub fn prompt(self, text: impl Into<LocalizedString>) -> Self

Prompt rendered above the input field. Optional but recommended.

pub fn placeholder(self, text: impl Into<LocalizedString>) -> Self

Placeholder shown when the field is empty.

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

Initial value pre-filled into the field.

pub fn ok_label(self, label: impl Into<LocalizedString>) -> Self

Override the OK button label (defaults to the framework’s translated “OK” string).

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

Override the Cancel button label (defaults to the framework’s translated “Cancel” string).

pub fn on_result( self, f: impl Fn(Option<String>, &mut EventContext<'_>) + 'static, ) -> Self

Result callback. Invoked exactly once when the user accepts (Some(value)) or cancels (None).

pub fn validate(self, f: impl Fn(&str) -> ValidateResult + 'static) -> Self

Install a live validator, run on every keystroke.

While it returns Err, the OK button is disabled and Enter does nothing, so on_result is only ever called with a value the validator accepted (or with None, for Cancel). Err(Some(msg)) shows msg under the field; Err(None) blocks without saying anything.

The message is withheld until the field has been edited, so a validator that rejects the empty string does not greet the writer with an error on a dialog they have not yet typed into. The disabled OK is what communicates “not yet” there.

Distinct from TextInput::validator, which fires on commit and cannot gate a dialog’s accept path.

pub fn present(self, ctx: &mut EventContext<'_>)

Present the dialog as a modal on top of ctx’s tree. Consumes self.

Trait Implementations

impl Debug for InputDialog

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.