Struct egui_modal::Modal

pub struct Modal { /* private fields */ }

A Modal is created using Modal::new(). Make sure to use a let binding when using Modal::new() to ensure you can call things like Modal::open() later on.

let modal = Modal::new("my_modal");
modal.show(ctx, |ui| {
    ui.label("Hello world!")
});
if ui.button("modal").clicked() {
    modal.open(ctx);
}

Implementations

impl Modal

pub fn new(ctx: &Context, id_source: impl Display) -> Self

Creates a new Modal. Can use constructor functions like Modal::with_style to modify upon creation.

pub fn open(&self)

Open the modal; make it visible. The modal prevents user input to other parts of the application.

pub fn close(&self)

Close the modal so that it is no longer visible, allowing input to flow back into the application.

pub fn with_close_on_outside_click(self, do_close_on_click_ouside: bool) -> Self

If set to true, the modal will close itself if the user clicks outside on the modal window (onto the overlay).

pub fn with_style(self, style: &ModalStyle) -> Self

Change the ModalStyle of the modal upon creation.

pub fn title(&self, ui: &mut Ui, text: impl Into<RichText>)

Helper function for styling the title of the modal.

pub fn body(&self, ui: &mut Ui, text: impl Into<RichText>)

Helper function for styling the body of the modal.

pub fn buttons<R>(&self, ui: &mut Ui, add_contents: impl FnOnce(&mut Ui) -> R)

Helper function for styling the button container of the modal.

pub fn button(&self, ui: &mut Ui, text: impl Into<RichText>) -> Response

Helper function for creating a normal button for the modal. Automatically closes the modal on click.

pub fn caution_button(&self, ui: &mut Ui, text: impl Into<RichText>) -> Response

Helper function for creating a “cautioned” button for the modal. Automatically closes the modal on click.

pub fn suggested_button(&self, ui: &mut Ui, text: impl Into<RichText>) -> Response

Helper function for creating a “suggested” button for the modal. Automatically closes the modal on click.

pub fn show<R>(&self, add_contents: impl FnOnce(&mut Ui) -> R)

The ui contained in this function will be shown within the modal window. The modal will only actually show when Modal::open is used.