18 releases (breaking)

0.14.0 Jul 14, 2024
0.12.1 Feb 13, 2024
0.10.1 Dec 12, 2023
0.10.0 Nov 25, 2023
0.2.0 May 18, 2022

#79 in GUI

Download history 914/week @ 2024-04-03 324/week @ 2024-04-10 238/week @ 2024-04-17 407/week @ 2024-04-24 215/week @ 2024-05-01 132/week @ 2024-05-08 283/week @ 2024-05-15 409/week @ 2024-05-22 472/week @ 2024-05-29 608/week @ 2024-06-05 424/week @ 2024-06-12 376/week @ 2024-06-19 423/week @ 2024-06-26 360/week @ 2024-07-03 472/week @ 2024-07-10 173/week @ 2024-07-17

1,503 downloads per month
Used in 7 crates (2 directly)

MIT license

2.5MB
307 lines

egui-toast

Latest version Documentation MIT

Toast notifications for the egui library.

Try it out in a web demo

Toast types

Quick start

cargo run -p egui-toast-demo
# or in wasm
cd demo && trunk serve
let mut toasts = Toasts::new()
    .anchor(Align2::RIGHT_BOTTOM, (-10.0, -10.0)) // 10 units from the bottom right corner
    .direction(egui::Direction::BottomUp);

if ui.button("Add toast").clicked() {
    toasts.add(Toast {
        text: "Hello, World!".into(),
        kind: ToastKind::Error,
        options: ToastOptions::default()
            .duration_in_seconds(5.0)
            .show_progress(true),
        ..Default::default()
    });
}

// Show and update all toasts
toasts.show(ctx);

Customization

Look of the notifications can be fully customized.

const MY_CUSTOM_TOAST: u32 = 0;

fn my_custom_toast_contents(ui: &mut Ui, toast: &mut Toast) -> Response {
    egui::Frame::default()
        .fill(Color32::from_rgb(33, 150, 243))
        .inner_margin(Margin::same(12.0))
        .rounding(4.0)
        .show(ui, |ui| {
            ui.label(toast.text.clone().color(Color32::WHITE));

            if ui.button("Close me").clicked() {
                toast.close();
            }
        }).response
}

let mut toasts = Toasts::new()
    .custom_contents(MY_CUSTOM_TOAST, my_custom_toast_contents);

if ui.button("Add toast").clicked() {
    toasts.add(Toast {
        text: "Hello, World!".into(),
        kind: ToastKind::Custom(MY_CUSTOM_TOAST),
        options: ToastOptions::default(),
        ..Default::default()
    });
}

toasts.show(ctx);

Dependencies

~4.5–9.5MB
~83K SLoC