Plantillas Jinja2 — Renderizado de páginas HTML
En este capítulo aprenderás a usar el motor de plantillas Jinja2 para renderizar páginas HTML completas y extraer el diseño común.
De cadenas a plantillas
En el capítulo anterior, las funciones de vista devolvían cadenas directamente, con etiquetas HTML incrustadas, lo que impedía la reutilización y dificultaba el mantenimiento.
render_template()Es el punto de entrada de Flask para renderizar plantillas: carga archivos HTML, inyecta variables y devuelve una respuesta HTML completa.
Ejemplo
from flask import Flask, render_template
app = Flask(__name__)
@app.route("/")
def index():
# render_template('nombre_de_plantilla', nombre_variable=valor, ...)
return render_template('index.html', title='Blog EJEMPLO')
Flask, por defecto, en el directorio raíz del proyecto,templates/busca plantillas en la carpeta `templates`.
Crear un archivo de plantilla
En el directorio raíz del proyecto, createmplates/la carpeta `templates`, y luego creaindex.html。
Ejemplo
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{{ title }}</title>
</head>
<body>
<h1>{{ title }}</h1>
<p>Bienvenido, esta es una página renderizada con el motor de plantillas Jinja2.</p>
</body>
</html>
Vistazo rápido a la sintaxis de plantillas Jinja2
La sintaxis de Jinja2 es casi idéntica a la de las plantillas de Django, y también similar a la sintaxis de interpolación de Vue3.
| Uso | Jinja2 / Django | Descripción |
|---|---|---|
| Salida de variables | {{ variable }} | Soporta acceso a atributos: {{ user.name }} |
| Bucle | {% for item in list %}...{% endfor %} | Soporta loop.index |
| Condición | {% if cond %}...{% endif %} | Se puede encadenar: {% elif %} |
| Herencia | {% extends 'base.html' %} | Debe estar en la primera línea |
| Definición de bloques | {% block name %}...{% endblock %} | La plantilla hija rellena los huecos de la plantilla padre |
Las sintaxis de Jinja2 y Django son casi iguales, pero Jinja2 es más flexible: puedes escribir expresiones de Python más complejas en las plantillas, mientras que Django restringe deliberadamente algunas capacidades para evitar que la lógica de negocio se filtre a las plantillas.
Herencia de plantillas: base.html
Varias páginas comparten la barra de navegación y el pie de página; usaherencia de plantillaspara evitar HTML duplicado.
Crear la plantilla padre base.html
Ejemplo
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- block title: la plantilla hija puede sobrescribir el título de la página -->
<title>{% block title %}Blog EJEMPLO{% endblock %}</title>
<style>
* { 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: #e74c3c; text-decoration: none; }
.navbar 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; }
</style>
{% block extra_head %}{% endblock %}
</head>
<body>
<header class="navbar">
<a href="/" class="logo">Blog EJEMPLO (Flask)</a>
<nav>
<a href="/">Inicio</a>
<a href="/about">Acerca de</a>
</nav>
</header>
<main class="container">
<!-- block content: la plantilla hija rellena aquí el contenido principal de la página -->
{% block content %}
{% endblock %}
</main>
<footer class="footer">
<p>© 2024 Blog EJEMPLO. Funciona con Flask.</p>
</footer>
</body>
</html>
La plantilla hija hereda la plantilla padre
Ejemplo
{% extends 'base.html' %}
{% block title %}Blog EJEMPLO - Inicio{% endblock %}
{% block content %}
<h2>Artículos recientes</h2>
<p>La lista de artículos se mostrará en capítulos posteriores.</p>
{% endblock %}
{% extends 'base.html' %}Debe escribirse en la primera línea de la plantilla hija (excepto los comentarios). Es un requisito estricto de Jinja2: el motor de plantillas necesita determinar la herencia en primer lugar.
url_for() para generar enlaces
No hardcodees las URL, usaurl_for()url_for() para resolver la dirección mediante el nombre de la función.
Ejemplo
@app.route("/")
def index(): ...
@app.route("/post/<int:post_id>")
def post_detail(post_id): ...
Ejemplo
Si la ruta cambia (por ejemplo,/post/se cambia a/article/), el `url_for()` en la plantillaurl_for()genera automáticamente la nueva dirección.
Configuración de archivos estáticos
Flask, por defecto, utilizastatic/el directorio `static` como raíz de los archivos estáticos.
blog_project/ ├── static/ │ ├── css/ │ │ └── style.css │ ├── js/ │ │ └── main.js │ └── images/ │ └── logo.png ├── templates/ └── app.py
En la plantilla, mediante `url_for('static', filename='...')`,url_for('static', filename='css/style.css')se hace referencia a ellos.
Resumen del capítulo
En este capítulo has dominado el núcleo de Jinja2: render_template() para renderizar plantillas, {{ }} para salida de variables, {% for/if %} para el flujo de control, base.html + block + extends para la herencia de plantillas, y url_for() para generar enlaces.
Ahora las páginas del blog se han convertido en HTML bien estructurado, y las partes comunes se han extraído a base.html.
Otras extensiones