Exemples Pratiques
Documentation / Exemples Pratiques / Autres exemples

Autres exemples

Flash messages — tous les types

Les macros success!, info!, warning!, error! stockent le message en session : il s'affiche à la page suivante, donc après une redirection.

pub async fn demo_messages(request: Request) -> AppResult<Response> {
    success!(request.notices => "Ceci est un message de succès.");
    info!(request.notices => "Ceci est un message d'information.");
    warning!(request.notices => "Ceci est un message d'avertissement.");
    error!(request.notices => "Ceci est un message d'erreur.");
    Ok(Redirect::to("/").into_response())
}

Pour un message sur la page rendue par la même requête (formulaire ré-affiché après une erreur), utiliser flash_now! :

context_update!(request => {
    "messages" => flash_now!(warning => "Vérifiez les champs."),
});
request.render("page.html")

{% messages %} affiche la clé messages du contexte : les messages de session arrivés avec la requête, ou ceux de flash_now! si vous la remplacez. Remplacée, elle perd les messages de session de cette requête.


API REST

Routes API

pub fn routes() -> Routes {
    urlpatterns! {
        "/api/articles" => view!{ api_list_articles }, name = "api_articles",
    }
}

Handler API JSON

use runique::prelude::*;
use runique::prelude::serde_json::json;

pub async fn api_list_articles(request: Request) -> AppResult<Response> {
    let articles = article::Entity::find()
        .all(&*request.engine.db)
        .await?;

    Ok(Json(json!({
        "count": articles.len(),
        "data": articles
    })).into_response())
}

data sérialise chaque colonne du modèle. Ne faites jamais ça sur une table qui contient un secret (les comptes : hash du mot de passe) : sélectionnez les colonnes à exposer, ou passez par une struct dédiée.

Un POST JSON est refusé en 403 par le middleware CSRF sans en-tête X-CSRF-Token valide. Un POST de formulaire HTML que la vue traite sans request.form (déconnexion, action) doit vérifier request.prisme.csrf_valid lui-même (voir Formulaires).


Template de base complet

<!-- templates/base.html -->
<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}Mon App{% endblock %}</title>
    <link rel="stylesheet" href='{% static "css/main.css" %}'>
    {% block extra_css %}{% endblock %}
</head>
<body>
    <header>
        <nav>
            <a href='{% link "index" %}'>Accueil</a>
            <a href='{% link "about" %}'>À propos</a>
            <a href='{% link "signup" %}'>Inscription</a>
        </nav>
    </header>

    {% messages %}

    <main>
        {% block content %}{% endblock %}
    </main>

    <footer>
        <p>&copy; 2026 — Propulsé par Runique</p>
    </footer>

    {% block extra_js %}{% endblock %}
</body>
</html>

Résumé des patterns

PatternQuand l'utiliser
request.render("template.html")Rendu HTML standard
Redirect::to("/").into_response()Après une action réussie (POST)
context_update!(request => {...})Injecter des variables dans le template
success!(request.notices => "...")Message flash avant redirect
flash_now!(error => "...")Message immédiat (pas de redirect)
ValidationForm::try_form(form, &request).awaitValider un formulaire (seulement s'il a été envoyé)
validated.save(&db).awaitSauvegarder en base (pas pour un compte : voir Formulaires)
form.forms_mut().database_error(&err)Afficher une erreur DB dans le formulaire