Теги шаблонов Django: ветвления, циклы и ссылки
Ветвления
Тег ветвления (тег проверки условия) if похож на оператор ветвления в Python:
Скопировать кодHTML
{% if news %}
У вас {{ news|length }} обновлений новостей
{% elif is_holiday %}
Новостей нет, сегодня же праздник!
{% else %}
Сегодня нет новостей.
{% endif %}
В условиях {% if %} работают операторы сравнения <, >, <=, >=, !=, ==, логические операторы or, and, not, операторы тождественности is и вхождения in, круглые скобки и стандартные правила приоритета операций.
В условиях можно применять и фильтры:
Скопировать кодHTML
{% if news|length >= 100 %}
Сегодня больше сотни новостей! Что случилось?
{% endif %}
Циклы
Тег for выполняет определённый код для каждого элемента списка, переданного в цикл.
Допустим, из view-функции в шаблон передан словарь dict_data, в нём есть элемент items, в этом элементе содержится словарь, всё содержимое которого вместе с ключами нужно вывести на страницу:
Скопировать кодHTML
{% for key, value in dict_data.items %}
Ключ '{{ key }}': Значение '{{ value }}'
{% endfor %}
Помимо обычных переменных в циклах создаются и вспомогательные, они доступны в специальной переменной forloop:
- forloop.counter — текущий счетчик выполнений цикла, начинается с 1;
- forloop.counter0 — текущий счетчик выполнения цикла, начинается с 0;
- forloop.revcounter — сколько итераций осталось до конца цикла, начинается с 1;
- forloop.revcounter0 — сколько итераций осталось до конца цикла, начинается с 0;
- forloop.first — вернёт True на первой итерации цикла, в остальных случаях вернёт False;
- forloop.last — вернёт True на последней итерации цикла, в остальных случаях вернёт False;
- forloop.parentloop — если цикл был запущен внутри другого цикла, то в этой переменной находится переменная
forloop родительского цикла.
Необязательный тег {% empty %}, вложенный в for, сработает, если переданный в цикл список пуст:
Скопировать кодHTML
<ul>
{% for news in news_list %}
<li>{{ news.title }}</li>
{% empty %}
<li>Список новостей пуст.</li>
{% endfor %}
</ul>
То же самое можно написать и без {% empty %}, но получится громоздко:
Скопировать кодHTML
<ul>
{% if news_list %}
{% for news in news_list %}
<li>{{ news.title }}</li>
{% endfor %}
{% else %}
<li>Список новостей пуст.</li>
{% endif %}
</ul>
Вложенный в for тег {% ifchanged %} запоминает значение переданных параметров или своего тела между запусками цикла, — и если они не поменялись, скрывает его.
В этом листинге HTML-заголовок <h2> с названием месяца будет выводиться на страницу только если в предыдущей итерации цикла название месяца было другим.
Скопировать кодHTML
<h1>Архив новостей за {{ year }}</h1>
{% for news in news_items %}
{% ifchanged %}
<h2>{{ news.pub_date|date:"F" }}</h2>
{% endifchanged %}
<h3>{{ news.pub_date|date:"d.m.Y" }} | {{ news.title}}</h3>
{% endfor %}
В результате работы цикла получится примерно такой HTML-код:
Скопировать кодHTML
<h1>Архив новостей за 2019</h1>
<h2>Январь</h2>
<h3>1.01.2019 | С Новым Годом!</h3>
<h3>2.01.2019 | С Днём научной фантастики!</h3>
<h3>3.01.2019 | С Днём рождения соломинки для коктейлей!</h3>
<h2>Февраль</h2>
<h3>1.02.2019 | С Днём работника лифтового хозяйства!</h3>
<h3>2.02.2019 | С Днём сурка!</h3>
<h3>2.02.2019 | С Днём сурка!</h3>
<h3>2.02.2019 | С Днём сурка!</h3>
Без тега {% ifchanged %} получилось бы хуже:
Скопировать кодHTML
<h1>Архив новостей за 2019</h1>
<h2>Январь</h2>
<h3>1.01.2019 | С Новым Годом!</h3>
<h2>Январь</h2>
<h3>2.01.2019 | С Днём научной фантастики!</h3>
<h2>Январь</h2>
<h3>3.01.2019 | С Днём рождения соломинки для коктейлей!</h3>
<h2>Февраль</h2>
<h3>1.02.2019 | С Днём работника лифтового хозяйства!</h3>
<h2>Февраль</h2>
<h3>2.02.2019 | С Днём сурка!</h3>
<h2>Февраль</h2>
<h3>2.02.2019 | С Днём сурка!</h3>
<h2>Февраль</h2>
<h3>2.02.2019 | С Днём сурка!</h3>
Тег url
Тег {% url %} генерирует ссылки на страницы проекта. Из кода шаблона можно обратиться к именам адресов, зарегистрированных в списке urlpatterns в файле urls.py, и передать параметры, если они требуются:
Скопировать кодPYTHON
urlpatterns = [
path('', views.index, name='index'),
path('/detail/<int:pk>/', views.details, name='detail'),
...
]
Первый параметр тега url — это name пути из файла urls.py:
Скопировать кодHTML
<a href="{% url 'index' %}">Главная</a>
После name при необходимости передаются значения переменных, которые принимает path() в urls.py
Скопировать кодHTML
urlpatterns = [
path('/detail/<int:pk>/', views.details, name='detail'),
path('/<str:username>/<int:id>/', views.article, name='article'),
]
{# передаём один параметр #}
<a href="{% url 'detail' 1 %}">Подробнее об объекте 1</a> {# получится ссылка detail/1 #}
<a href="{% url 'detail' pk=1 %}">Подробнее об объекте 1</a>
<a href="{% url 'detail' pk=object.id %}">Подробнее об объекте {{ object.id }}</a>
{# передаём несколько параметров #}
<a href="{% url 'article' 'anton' 16 %}">Статья с ID=16, автор: anton</a>
<a href="{% url 'article' username='anton' id=16 %}">Статья с ID=16, автор: anton</a>
<a href="{% url 'article' username=article.username id=article.id %}">Статья с ID={{ article.id }}, автор: {{ article.username }}</a>
