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 min_width(self, width: f32) -> Self

Set the minimum width constraint for the dialog

Parameters

• width: The minimum width in pixels (default: 280.0)

Returns

Self for method chaining

pub fn max_height(self, height: f32) -> Self

Set the maximum height constraint for the dialog

Parameters

• height: The maximum height in pixels

Returns

Self for method chaining

pub fn title_padding(self, padding: [f32; 4]) -> Self

Set custom padding for the title area

Parameters

• padding: [left, right, top, bottom] padding in pixels

Returns

Self for method chaining

pub fn content_padding(self, padding: [f32; 4]) -> Self

Set custom padding for the content area

Parameters

• padding: [left, right, top, bottom] padding in pixels

Returns

Self for method chaining

pub fn actions_padding(self, padding: [f32; 4]) -> Self

Set custom padding for the actions area

Parameters

• padding: [left, right, top, bottom] padding in pixels

Returns

Self for method chaining

pub fn button_padding(self, padding: [f32; 2]) -> Self

Set custom padding for individual action buttons

Parameters

• padding: [horizontal, vertical] padding in pixels

Returns

Self for method chaining

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

Set whether the content should be scrollable

Parameters

• scrollable: If true, content will be placed in a ScrollArea

Returns

Self for method chaining

pub fn actions_spacing(self, spacing: f32) -> Self

Set the spacing between action buttons

Parameters

• spacing: Spacing in pixels (default: 8.0)

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