Django_-_podrobnoe_rukovodstvo

Тег ifchanged употребляется внутри цикла;­ возможные варианты использования:

•• Сравнивает содержимое, предназначенное для вывода, с тем, что было выведено на предыдущей итерации, и производит вывод, только если обнаружены изменения. Например, выведем список дат, печатая месяц, только если он изменился по сравнению с предыдущей датой:

<h1Архив за {{ year }}</h1>

{% for date in days %}

{% ifchanged %}<h3>{{ date|date:”F” }}</h3>{% endifchanged %} <a href=”{{ date|date:”M/d”|lower }}/”>{{ date|date:”j” }}</a>

{% endfor %}

•• Если задана переменная, то проверяет, изменилось ли ее значение. Например, в следующем фрагменте дата выводится при каждой смене, но час печатается, только если изменились одновременно и час, и дата:

{% for date in days %}

{% ifchanged date.date %} {{ date.date }} {% endifchanged %} {% ifchanged date.hour date.date %}

{{ date.hour }} {% endifchanged %}

{% endfor %}

В теге ifchanged может присутствовать необязательная часть {% else %}, которая отображается, если значение не изменилось:

{% for match in matches %}

<div style=”background-color:

{% ifchanged match.ballot_id %} {% cycle red,blue %}

{% else %} grey

{% endifchanged %} “>{{ match }}</div>

{% endfor %}

ifequal

Выводит содержимое блока, если оба аргумента тега равны. Например:

{% ifequal user.id comment.user_id %}

...

{% endifequal %}

Как и в теге {% if %}, может присутствовать необязательная часть {% else %}.

В роли аргументов допускается использовать строковые литералы, то есть следующая конструкция тоже допустима:

Аргумент можно сравнивать только с шаблонными­ переменными или строками. Не допускается сравнивать с объектами Python, например, True или False. В случае такой необходимости пользуйтесь тегом if.

ifnotequal

Аналогичен ifequal, но проверяется различие аргументов.

include

Загружает шаблон­ и производит его отображение в текущем контексте. Таким способом можно включать один шаблон­ в другой.

Имя шаблона­ может быть переменной или строковым литералом, заключенным в одиночные или двойные кавычки.

Вследующем примере включается содержимое шаблона­ “foo/bar.html”:

{% include “foo/bar.html” %}

Аздесь включается содержимое шаблона,­ имя которого содержится в переменной template_name:

{% include template_name %}

Отображение включаемого шаблона­ производится в контексте включающего шаблона­. В следующем примере выводится строка “Привет, Джон”:

•• Контекст: переменная person имеет значение “Джон”.

•• Шаблон:­

{% include “name_snippet.html” %}

•• Шаблон­ name_snippet.html:

Привет, {{ person }}

См. также: {% ssi %}.

load

Загружает набор пользовательских шаблонных­ тегов. О библиотеках пользовательских тегов см. главу 9.

now

Выводит текущую дату в соответствии с указанной строкой формата.

Синтаксис определения формата такой же, как в PHP-функции date() (http://php.net/date) с некоторыми дополнениями.

В табл. E.2 показаны все имеющиеся спецификаторы формата.

BНе реализовано

fВремя в 12-часовом формате с часами ‘1’, ‘1:30’ и минутами. Если количество минут

равно нулю, минуты отбрасываются. Добавлен в Django.

IНе реализовано

LБулевский признак високосного года True или False

интерпретировался бы как спецификатор для вывода времени. Символ же ‘o’ экранировать не нужно, потому что такого спецификатора фор-

мата не существует:

It is the {% now “jS o\f F” %}

В результате будет выведена строка «It is the 4th of September».

regroup

Перегруппировывает список похожих объектов по общему атрибуту.

Работу этого хитрого тега лучше всего проиллюстрировать на примере. Предположим, что people – список людей, информация о каждом из которых представлена словарем с ключами first_name (имя), last_name (фамилия) и gender (пол):

people = [

{‘first_name’: ‘Джордж’, ‘last_name’: ‘Буш’, ‘gender’: ‘Мужской’}, {‘first_name’: ‘Билл’, ‘last_name’: ‘Клинтон’, ‘gender’: ‘Мужской’}, {‘first_name’: ‘Маргарет’, ‘last_name’: ‘Тэтчер’, ‘gender’: ‘Женский’}, {‘first_name’: ‘Кондолиза’, ‘last_name’: ‘Райс’, ‘gender’: ‘Женский’}, {‘first_name’: ‘Пэт’, ‘last_name’: ‘Смит’, ‘gender’: ‘Неизвестен’},

]

И вы хотите вывести иерархический список, упорядоченный по полу, например:

•• Мужской:

•• Джордж Буш

•• Билл Клинтон

•• Женский:

•• Маргарет Тэтчер

•• Кондолиза Райс

•• Неизвестен:

•• Пэт Смит

Для группировки по полу можно воспользоваться тегом {% regroup %}, как показано ниже:

{% regroup people by gender as gender_list %} <ul>

{% for gender in gender_list %} <li>{{ gender.grouper }} <ul>

{% for item in gender.list %}

<li>{{ item.first_name }} {{ item.last_name }}</li> {% endfor %}

</ul>

</li>

{% endfor %} </ul>

Разберемся, что здесь происходит. Тег {% regroup %} принимает три аргумента: список, который нужно перегруппировать; атрибут, по которому производится группировка, и имя результирующего списка. В данном случае мы хотим перегруппировать список people по атрибуту gender и назвать результат gender_list.

Тег {% regroup %} порождает список (в нашем случае gender_list) групповых объектов. У каждого группового объекта есть два атрибута:

•• grouper: имя атрибута, по которому образована группа (например, строка “Мужской” или “Женский”).

•• list: список всех элементов этой группы (например, список людей, для которых gender=’Мужской’).

Отметим, что тег {% regroup %} не сортирует входные данные! В нашем примере предполагалось, что список people изначально отсортирован по атрибуту gender. Если бы это было не так, то в результате перегруппировки образовалось бы несколько групп с одним и тем же значением пола. Например, пусть исходный список people выглядит так (обратите внимание, что мужчины не сгруппированы вместе):

people = [

{‘first_name’: ‘Билл’, ‘last_name’: ‘Клинтон’, ‘gender’: ‘Мужской’}, {‘first_name’: ‘Пэт’, ‘last_name’: ‘Смит’, ‘gender’: ‘Неизвестен’}, {‘first_name’: ‘Маргарет’, ‘last_name’: ‘Тэтчер’, ‘gender’: ‘Женский’}, {‘first_name’: ‘Джордж’, ‘last_name’: ‘Буш’, ‘gender’: ‘Мужской’}, {‘first_name’: ‘Кондолиза’, ‘last_name’: ‘Райс’, ‘gender’: ‘Женский’},

]

Если передать такой список people предыдущему фрагменту шаблона­ {% regroup %}, он породит такой результат:

•• Мужской:

•• Билл Клинтон

•• Неизвестен:

•• Пэт Смит

•• Женский:

•• Маргарет Тэтчер

•• Мужской:

•• Джордж Буш

•• Женский:

•• Кондолиза Райс

Чтобы решить эту проблему, проще всего заранее отсортировать список данных и только потом передавать его в шаблон­.