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
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
<img src="/static/images/logo.png">
Configurer les modèles Jinja2
Exemple
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 recevoir
request: 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
<!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
{% 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
def post_detail(request: Request, post_id: int):
return templates.TemplateResponse("post_detail.html",
{"request": request, ...})
Exemple
<a href="{{ url_for('post_detail', post_id=3) }}">Article 3</a>
Créer des styles CSS de base
Exemple
* { 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