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

# Ruta del archivo: app.py
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

<!-- Ruta del archivo: templates/index.html -->
<!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.

UsoJinja2 / DjangoDescripció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

<!-- Ruta del archivo: 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">
    <!-- 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

<!-- Ruta del archivo: templates/index.html -->
{% 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

# En views.py se define el endpoint de la ruta
@app.route("/")
def index(): ...

@app.route("/post/<int:post_id>")
def post_detail(post_id): ...

Ejemplo

[mycode4 type="html"> Generar enlaces con url_for() en la plantilla Inicio Artículo 3 Referenciar archivos estáticos [/mycode4]

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