Шаблоны Jinja2 — Рендеринг HTML-страниц

В этой главе вы научитесь использовать движок шаблонов Jinja2 для рендеринга полноценных HTML-страниц и выделения общих макетов.


От строк к шаблонам

В предыдущей главе функции представления напрямую возвращали строки с HTML-тегами, встроенными в них; такие строки нельзя было повторно использовать, и их было сложно поддерживать.

render_template()Это точка входа для рендеринга шаблонов Flask: она загружает HTML-файлы, подставляет переменные и возвращает полный HTML-ответ.

Пример

# Путь к файлу: app.py
from flask import Flask, render_template

app = Flask(__name__)

@app.route("/")
def index():
    # render_template('template file name', variable name=value, ...)
    return render_template('index.html', title='EXAMPLE Blog')

Flask по умолчанию, в корневой директории проектаtemplates/ищет шаблоны в папке.


Создайте файлы шаблонов

Создайте в корневом каталоге проектаtemplates/папку, затем создайтеindex.html。

Пример

<!-- Путь к файлу: templates/index.html -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>{{ title }}</title>
</head>
<body>
    <h1>{{ title }}</h1>
    <p>Добро пожаловать, это страница, отрендеренная с помощью шаблонизатора Jinja2.</p>
</body>
</html>

Обзор синтаксиса шаблонов Jinja2

Синтаксис Jinja2 почти точно совпадает с синтаксисом шаблонов Django и также похож на синтаксис интерполяции Vue3.

НазначениеJinja2 / DjangoОписание
Вывод переменных{{ variable }}Поддерживает доступ к атрибутам: {{ user.name }}
Циклы{% for item in list %}...{% endfor %}Поддерживает loop.index
Условия{% if cond %}...{% endif %}Можно объединять в цепочку: {% elif %}
Наследование{% extends 'base.html' %}Должен быть в первой строке
Определения блоков{% block name %}...{% endblock %}Дочерние шаблоны заполняют пропуски родительского шаблона

Синтаксис шаблонов Jinja2 и Django почти одинаков, но Jinja2 более гибок: в шаблонах можно писать более сложные выражения Python, тогда как шаблоны Django намеренно ограничивают некоторые возможности, чтобы бизнес-логика не проникала в шаблоны.


Наследование шаблонов: base.html

Несколько страниц совместно используют панель навигации и нижний колонтитул, используйтенаследование шаблоновИзбегайте дублирования HTML.

Создание родительского шаблона base.html

Пример

<!-- Путь к файлу: 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: дочерний шаблон может переопределить заголовок страницы -->
    <title>{% block title %}EXAMPLE Blog{% 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">ПРИМЕР Блог (Flask)</a>
        <nav>
            <a href="/">Главная</a>
            <a href="/about">О нас</a>
        </nav>
    </header>

    <main class="container">
        <!-- block content: дочерний шаблон заполняет здесь основное содержимое страницы -->
        {% block content %}
        {% endblock %}
    </main>

    <footer class="footer">
        <p>© 2024 EXAMPLE Blog. Работает на Flask.</p>
    </footer>
</body>
</html>

Дочерние шаблоны наследуют родительский шаблон

Пример

<!-- Путь к файлу: templates/index.html -->
{% extends 'base.html' %}

{% block title %}EXAMPLE Blog - Главная{% endblock %}

{% block content %}
<h2>Последние статьи</h2>
<p>Список статей будет отображаться в следующих главах.</p>
{% endblock %}

{% extends 'base.html' %}Это должно быть записано в первой строке дочернего шаблона (кроме комментариев). Это обязательное требование Jinja2 — механизму шаблонов сначала нужно определить отношение наследования.


url_for() генерирует ссылки

Не прописывайте URL жёстко, используйтеurl_for(). Ищите адрес по имени функции.

Пример

# Определите конечную точку маршрута в views.py
@app.route("/")
def index(): ...

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

Пример

[mycode4 type="html"> В шаблонах url_for() генерирует ссылки Главная Статья 3 Ссылки на статические файлы [/mycode4]

Маршрут изменился (например,/post/Изменить на/article/), в шаблонеurl_for()Автоматически генерировать новые адреса.


Конфигурация статических файлов

Flask по умолчанию будетstatic/каталог в качестве корневого каталога статических файлов.

blog_project/
├── static/
│   ├── css/
│   │   └── style.css
│   ├── js/
│   │   └── main.js
│   └── images/
│       └── logo.png
├── templates/
└── app.py

В шаблонах черезurl_for('static', filename='css/style.css')ссылка.


Итоги главы

В этой главе вы освоили основу шаблонов Jinja2: render_template() для рендеринга шаблонов, {{ }} для вывода переменных, управляющие конструкции {% for/if %}, наследование шаблонов base.html + block + extends и url_for() для генерации ссылок.

Теперь страница блога стала хорошо структурированным HTML, а общие части были вынесены в base.html.

Другие расширения