Struct MaterialDialog 

pub struct MaterialDialog<'a> { /* private fields */ }

Material Design dialog component following Material Design 3 specifications

Dialogs interrupt users with overlaid content that requires a response. They appear above all other content and disable all app functionality when shown.

Usage Examples

let mut dialog_open = false;
 
// Basic dialog
let dialog = MaterialDialog::new("my_dialog", "Confirm Action", &mut dialog_open)
    .content(|ui| {
        ui.label("Are you sure you want to proceed?");
    })
    .action("Cancel", ActionType::Text, || {
        // Cancel action
    })
    .action("Confirm", ActionType::Filled, || {
        // Confirm action  
    });
 
dialog.show(ui.ctx());

Material Design Spec

• Max width: 560dp on large screens
• Corner radius: 28dp
• Elevation: 6dp (24dp shadow)
• Surface color background
• Minimum touch target: 48x48dp for actions

Implementations

impl<'a> MaterialDialog<'a>

pub fn new( id: impl Into<Id>, title: impl Into<String>, open: &'a mut bool, ) -> Self

Create a new Material Design dialog

Parameters

• id: Unique identifier for the dialog (used for egui state)
• title: Title text displayed at the top of the dialog
• open: Mutable reference to boolean controlling dialog visibility

Returns

A new MaterialDialog instance ready for customization

pub fn dialog_type(self, dialog_type: DialogType) -> Self

Set the dialog type (affects styling and behavior)

Parameters

• dialog_type: The type of dialog to display

Returns

Self for method chaining

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

Set an optional icon to display in the dialog header

Parameters

• icon: The icon to display (as a string identifier)

Returns

Self for method chaining

pub fn content<F>(self, content: F) -> Self

where F: FnOnce(&mut Ui) + 'a,

Set the content of the dialog

Parameters

• content: A closure that renders the content UI

Returns

Self for method chaining

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

Set whether this is a quick/temporary dialog

Parameters

• quick: If true, the dialog is considered quick/temporary

Returns

Self for method chaining

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

Set whether to disable focus trapping within the dialog

Parameters

• no_focus_trap: If true, focus trapping is disabled

Returns

Self for method chaining

pub fn max_width(self, width: f32) -> Self

Set the maximum width constraint for the dialog

Parameters

• width: The maximum width in pixels

Returns

Self for method chaining

pub fn text_action<F>(self, text: impl Into<String>, action: F) -> Self

where F: FnOnce() + 'a,

Add a text action button to the dialog

Parameters

• text: The text label for the button
• action: A closure that is called when the button is clicked

Returns

Self for method chaining

pub fn filled_tonal_action<F>(self, text: impl Into<String>, action: F) -> Self

where F: FnOnce() + 'a,

Add a filled tonal action button to the dialog

Parameters

• text: The text label for the button
• action: A closure that is called when the button is clicked

Returns

Self for method chaining

pub fn filled_action<F>(self, text: impl Into<String>, action: F) -> Self

where F: FnOnce() + 'a,

Add a filled action button to the dialog

Parameters

• text: The text label for the button
• action: A closure that is called when the button is clicked

Returns

Self for method chaining

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

where F: FnOnce() + 'a,

Backward compatibility methods

These methods exist to support older code that used different naming conventions for actions. They are functionally equivalent to the more descriptively named methods introduced later.

Parameters

• text: The text label for the button
• action: A closure that is called when the button is clicked

Returns

Self for method chaining

pub fn primary_action<F>(self, text: impl Into<String>, action: F) -> Self

where F: FnOnce() + 'a,

Backward compatibility method for primary actions

This method is provided for convenience and is functionally equivalent to filled_action.

Parameters

• text: The text label for the button
• action: A closure that is called when the button is clicked

Returns

Self for method chaining

pub fn show(self, ctx: &Context)

Show the dialog, rendering it in the given context

Parameters

• ctx: The egui context used for rendering the dialog

Behavior

• The dialog will be displayed as an overlay, blocking interaction with other windows
• Clicking outside the dialog or pressing the escape key will close the dialog
• Action buttons will execute their associated actions when clicked