Flash Messages

Server-side session notifications, displayed once after redirect.

Click the button to inject all 4 message types and see them displayed.

4 available levels

Success — successful action, save, login
Info — neutral information
Warning — attention required
Error — error, access denied

views.rs — injection in the view

pub async fn about(
    mut request: Request,
) -> AppResult<Response> {
    success!(request.notices => "Action successful.");
    info!(request.notices => "Information message.");
    warning!(request.notices => "Attention required.");
    error!(request.notices => "An error occurred.");

    request.render("about/about.html")
}

views.rs — typical redirect pattern

// After an action: add + redirect
pub async fn create_post(
    mut request: Request,
) -> AppResult<Response> {
    let form: BlogForm = request.form("blog");
    let form = match ValidationForm::try_form(form, &request).await {
        Ok(validated) => validated,
        Err(form) => {
            context_update!(request => { "blog_form" => &form });
            return request.render("blog/blog.html");
        }
    };
    if form.save(&request.engine.db).await.is_ok() {
        success!(request.notices => "Article published!");
    }
    Ok(Redirect::to("/blog").into_response())
}

flash_now! — immediate message without session

// Display the message on the current page (no redirect)
context_update!(request => {
    "messages" => flash_now!(error => "Invalid form."),
});

index.html — display in the template

<!-- dans le layout de base -->
<main>
    {% block messages %}
        {% messages %}
    {% endblock %}
    {% block content %}{% endblock %}
</main>

Documentation ← Back home