Modèle Jinja2

Dans ce chapitre, vous apprendrez à utiliser le moteur de modèles Jinja2 dans FastAPI, en utilisant des fichiers statiques et l'héritage de modèles pour construire des pages HTML complètes.


Les deux modes de rendu de FastAPI

FastAPI renvoie du JSON par défaut (adapté aux API), mais il peut aussi renvoyer du HTML (adapté aux pages web).

Les modes peuvent coexister — un même projet peut à la fois fournir une API JSON et afficher des pages web.


Monter des fichiers statiques

Les fichiers statiques (CSS, JS, images) sont gérés viaStaticFilesMonter sur le chemin spécifié.

Exemple

# Chemin du fichier : main.py
from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

# Monter le répertoire static/ vers le chemin /static
# Accéder à /static/css/style.css → lit en réalité static/css/style.css
app.mount("/static", StaticFiles(directory="static"), name="static")

Référencer les fichiers statiques dans les modèles :

Exemple

<link rel="stylesheet" href="/static/css/style.css">
<img src="/static/images/logo.png">

Configurer les modèles Jinja2

Exemple

# Chemin du fichier : main.py
from fastapi import FastAPI, Request
from fastapi.staticfiles import StaticFiles
from fastapi.templating import Jinja2Templates

app = FastAPI()
app.mount("/static", StaticFiles(directory="static"), name="static")

# Spécifier le répertoire des modèles
templates = Jinja2Templates(directory="templates")

@app.get("/")
def index(request: Request):       # Remarque : la route du modèle doit recevoir un paramètre Request.
    """Page d'accueil du blog"""
    return templates.TemplateResponse(
        "index.html",              # Nom du fichier modèle
        {                          # données de contexte
            "request": request,    # request doit être transmis (exigence de Jinja2Templates)
            "title": "blog EXEMPLE"
        }
    )

Le rendu de modèle de FastAPI présente deux différences clés par rapport à Flask : 1. La fonction de vue doit recevoirrequest: Requestparamètre ; 2.requestDoit être transmis au modèle en tant que contexte. Si request est omis, la fonction url_for dans le modèle échouera.


Créer le gabarit parent base.html

Exemple

<!-- Chemin du fichier : templates/base.html -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}EXAMPLE Blog{% endblock %}</title>
    <link rel="stylesheet" href="/static/css/style.css">
    {% block extra_head %}{% endblock %}
</head>
<body>
    <header class="navbar">
        <a href="/" class="logo">EXAMPLE Blog (FastAPI)</a>
        <nav>
            <a href="/">Accueil</a>
            <a href="#">À propos</a>
        </nav>
    </header>

    <main class="container">
        {% block content %}{% endblock %}
    </main>

    <footer class="footer">
        <p>© 2024 EXAMPLE Blog. Propulsé par FastAPI.</p>
    </footer>
</body>
</html>

Créer le template enfant index.html

Exemple

<!-- Chemin du fichier : templates/index.html -->
{% extends 'base.html' %}

{% block title %}{{ title }}{% endblock %}

{% block content %}
<h2 class="section-title">Derniers articles</h2>
<p>La liste des articles sera affichée dans les chapitres suivants.</p>
{% endblock %}

url_for() dans les templates FastAPI

Comme Flask, FastAPI prend également en chargeurl_for(), mais vous devez d'abord nommer la route.

Exemple

@app.get("/post/{post_id}", name="post_detail")   # name= nomme la route
def post_detail(request: Request, post_id: int):
    return templates.TemplateResponse("post_detail.html",
        {"request": request, ...})

Exemple

<!-- Référence dans le modèle -->
<a href="{{ url_for('post_detail', post_id=3) }}">Article 3</a>

Créer des styles CSS de base

Exemple

/* Chemin du fichier : static/css/style.css */
* { margin: 0; padding: 0; box-sizing: border-box; }

body {
    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    background: #f5f5f5;
    color: #333;
}

.navbar {
    display: flex; justify-content: space-between; align-items: center;
    padding: 16px 40px; background: #fff;
    box-shadow: 0 2px 8px rgba(0,0,0,0.1);
}

.navbar .logo {
    font-size: 22px; font-weight: bold;
    color: #009688; text-decoration: none;
}

.navbar nav a {
    margin-left: 20px; text-decoration: none; color: #333;
}

.container { max-width: 960px; margin: 40px auto; padding: 0 20px; }

.footer { text-align: center; padding: 20px; color: #999; border-top: 1px solid #eee; }

.section-title { font-size: 24px; margin-bottom: 20px; }

Résumé du chapitre

Dans ce chapitre, vous avez appris la configuration du rendu frontend dans FastAPI : StaticFiles pour monter des ressources statiques, Jinja2Templates pour configurer le répertoire des templates, TemplateResponse pour renvoyer du HTML, et les principales différences avec Flask dans le rendu de templates (le paramètre Request doit être passé).

autres extensions