Синтаксис Jinja для Django: Полный гайд

4 октября 2024 г.

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

Основной синтаксис Jinja

Переменные

Для вывода переменной в шаблоне используется следующий синтаксис:

{{ переменная }}

Пример: <p>Привет, {{ user.username }}!</p>

Фильтры

Фильтры позволяют изменять данные прямо в шаблоне перед выводом. Вот пример использования фильтра для преобразования текста в верхний регистр:

{{ переменная|upper }}

Часто используемые фильтры:

upper — переводит строку в верхний регистр.
lower — переводит строку в нижний регистр.
length — возвращает длину списка или строки.
default — задает значение по умолчанию, если переменная None.

Пример использования: <p>Количество элементов: {{ items|length }}</p>

Циклы

Jinja поддерживает циклы для итерации по спискам:

<ul> {% for item in items %} <li>{{ item }}</li> {% endfor %} </ul>

Также есть дополнительные возможности для работы с циклами:

loop.index — текущий индекс (начинается с 1).
loop.first — возвращает True, если это первый элемент.
loop.last — возвращает True, если это последний элемент.

Пример:

<ul> {% for post in posts %} <li> {{ post.title }} {% if loop.first %}(Первый пост!){% endif %} </li> {% endfor %} </ul>

Условные операторы

Условные конструкции позволяют выводить информацию на основе определённых условий:

{% if user.is_authenticated %} <p>Привет, {{ user.username }}!</p> {% else %} <p>Привет, гость!</p> {% endif %}

Можно использовать и более сложные условия с elif:

{% if user.is_superuser %} <p>Добро пожаловать, администратор!</p> {% elif user.is_staff %} <p>Привет, сотрудник!</p> {% else %} <p>Привет, пользователь!</p> {% endif %}

Наследование шаблонов

Одной из мощных возможностей Jinja является поддержка наследования шаблонов. Это позволяет создавать базовые шаблоны, которые могут быть расширены в дочерних. Например, у нас может быть базовый шаблон:

<!DOCTYPE html> <html> <head> <title>{% block title %}Мой сайт{% endblock %}</title> </head> <body> <header> {% block header %}<h1>Заголовок сайта{% endblock %}</h1> </header> <main> {% block content %}{% endblock %} </main> <footer> {% block footer %}Мой футер{% endblock %} </footer> </body> </html>

А теперь в дочернем шаблоне мы можем переопределить блоки title, header и content:

{% extends 'base.html' %}

{% block title %}Главная страница{% endblock %}

{% block header %} <h1>Добро пожаловать на главную страницу!</h1> {% endblock %}

{% block content %} <p>Это контент главной страницы.</p> {% endblock %}

Макросы

Jinja поддерживает макросы, которые позволяют переиспользовать фрагменты кода в разных местах шаблона, что удобно для повторяющихся элементов, например, форм.

Пример макроса для рендеринга полей формы:

{% macro render_field(field) %} <div class="form-group"> <label for="{{ field.id }}">{{ field.label }}</label> {{ field }} </div> {% endmacro %}

Вызываем макрос так: {{ render_field(form.username) }}

Включение шаблонов

Шаблоны могут включать другие шаблоны с помощью тега include. Это полезно, если вам нужно вставить повторяющийся HTML-код, например, меню или хэдер:

{% include 'partials/navbar.html' %}

Заключение

Jinja — это мощный инструмент для работы с шаблонами в Django. Он поддерживает гибкий синтаксис, быстрый рендеринг и множество полезных функций, таких как макросы и наследование. Благодаря этому Jinja2 может помочь вам создавать более чистые, структурированные и расширяемые шаблоны, улучшая код вашего проекта.