Шаблоны Jinja2 — Рендеринг HTML-страниц
В этой главе вы научитесь использовать движок шаблонов Jinja2 для рендеринга полноценных HTML-страниц и выделения общих макетов.
От строк к шаблонам
В предыдущей главе функции представления напрямую возвращали строки с HTML-тегами, встроенными в них; такие строки нельзя было повторно использовать, и их было сложно поддерживать.
render_template()Это точка входа для рендеринга шаблонов Flask: она загружает HTML-файлы, подставляет переменные и возвращает полный HTML-ответ.
Пример
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。
Пример
<!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
Пример
<!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>
Дочерние шаблоны наследуют родительский шаблон
Пример
{% extends 'base.html' %}
{% block title %}EXAMPLE Blog - Главная{% endblock %}
{% block content %}
<h2>Последние статьи</h2>
<p>Список статей будет отображаться в следующих главах.</p>
{% endblock %}
{% extends 'base.html' %}Это должно быть записано в первой строке дочернего шаблона (кроме комментариев). Это обязательное требование Jinja2 — механизму шаблонов сначала нужно определить отношение наследования.
url_for() генерирует ссылки
Не прописывайте URL жёстко, используйтеurl_for(). Ищите адрес по имени функции.
Пример
@app.route("/")
def index(): ...
@app.route("/post/<int:post_id>")
def post_detail(post_id): ...
Пример
Маршрут изменился (например,/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.
Другие расширения