Встроенные шаблонные теги и фильтры¶

Этот раздел описывает строенные шаблонные теги и фильтры Django. Рекомендуем использовать автоматическую документацию по возможности, т.к. она включает так же собственные теги и фильтры.

Список встроенных тегов¶

autoescape¶

Контролирует авто-экранирование. Этот тег принимает on или off аргумент, указывающий должно ли использоваться автоматическое экранирование внутри блока. Блок закрывается закрывающим тегом endautoescape.

Если экранирование включено, ко всем переменным будет применяется HTML-экранирование перед выводом (но после применения всех фильтров). Это эквивалентно использованию фильтра escape для каждой переменной.

Не будут экранированы переменные помеченные как безопасные( “safe”), или кодом определяющим переменную, или после применения фильтров safe или escape.

Примеры использования:

{% autoescape on %}
    {{ body }}
{% endautoescape %}

block¶

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

comment¶

Игнорирует все между {% comment %} и {% endcomment %}

csrf_token¶

В Django 1.1.X, это ничего не делающий тег, который возвращает пустую строку, добавленный для совместимости версий. В Django 1.2 и выше, используется для CSRF защиты, как описано в разделе о Cross Site Request Forgeries.

cycle¶

Циклически перебирает переданные строки или значения каждый раз, когда выполняется тег.

В цикле, поочередно выводит строку переданную в тег:

{% for o in some_list %}
    <tr class="{% cycle 'row1' 'row2' %}">
        ...
    </tr>
{% endfor %}

Вы можете так же использовать переменные. Например, если у вас есть две переменных в шаблоне, rowvalue1 и rowvalue2, вы можете переключаться между их значениями:

{% for o in some_list %}
    <tr class="{% cycle rowvalue1 rowvalue2 %}">
        ...
    </tr>
{% endfor %}

Обратите внимание, что переменные используемые в качестве аргументов (rowvalue1 и rowvalue2 из примера выше) НЕ будут экранированы! Так что или убедитесь, что вы доверяете переменным, или используйте явное экранирование, например:

{% for o in some_list %}
    <tr class="{% filter force_escape %}{% cycle rowvalue1 rowvalue2 %}{% endfilter %}">
        ...
    </tr>
{% endfor %}

В можете использовать переменные и строки вместе:

{% for o in some_list %}
    <tr class="{% cycle 'row1' rowvalue2 'row3' %}">
        ...
    </tr>
{% endfor %}

В некоторых случаях вам может понадобиться обратиться к значению не в цикле. Что бы сделать это, просто передайте в тег {% cycle %} название, используя “as”, например:

{% cycle 'row1' 'row2' as rowcolors %}

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

<tr>
    <td class="{% cycle 'row1' 'row2' as rowcolors %}">...</td>
    <td class="{{ rowcolors }}">...</td>
</tr>
<tr>
    <td class="{% cycle rowcolors %}">...</td>
    <td class="{{ rowcolors }}">...</td>
</tr>

выведет:

<tr>
    <td class="row1">...</td>
    <td class="row1">...</td>
</tr>
<tr>
    <td class="row2">...</td>
    <td class="row2">...</td>
</tr>

Вы можете использовать любое количество значений в теге {% cycle %}, разделенных пробелами. Значения в одинарных (') или двойных кавычках (") рассматриваются как строки, в то время как, значения без кавычек, интерпретируются как переменные.

Переменные не будут экранированы. Это потому, что теги не экранируют свое содержимое. Любой HTML или Javascript код в переменных будет выведен как есть, что может привести к проблемам с защитой.

Для обратной совместимости, тег {% cycle %} поддерживает старый синтаксис предыдущих версий Django. Вы не должны его использовать в новых проектах, но для тех кому интересно он выглядит таким образом:

{% cycle row1,row2,row3 %}

Такой синтаксис воспринимает все как строки, и нет возможности передать переменные, использовать запятую или пробел в качестве значения. Мы уже говорили что не следует использовать этот синтаксис в новых проектах?

Добавлено в Django 1.3: Пожалуйста, обратитесь к описанию релиза

По-умолчанию, использование тега {% cycle %} с аргументом as выведет первое значение цикла. Это может быть проблемой, если вы хотите использовать значение во вложенном теге или в включенном теге. Если вы хотите просто определить цикл, но не выводить первое значение, используйте аргумент silent в конце тега. Например:

{% for obj in some_list %}
    {% cycle 'row1' 'row2' as rowcolors silent %}
    <tr class="{{ rowcolors }}">{% include "subtemplate.html " %}</tr>
{% endfor %}

Это выведет список элементов <tr> с class чередующийся между row1 и row2; включенный шаблон будет иметь доступ к переменной rowcolors, которая содержит класс <tr>. Если бы аргумент silent не использовался, row1 вывелся бы в элементе <tr> как обычный тег.

Если используется аргумент silent, он будет автоматически применен ко всем последующим вызовам этого цикла. Этот шаблон ничего не выведет, даже учитывая что второй вызов {% cycle %} не использует silent:

{% cycle 'row1' 'row2' as rowcolors silent %}
{% cycle rowcolors %}

debug¶

Выводит всю отладочную информацию, в том числе текущей контекст и импортированные модули.

extends¶

Указывает что данный шаблон наследуется от родительского.

Может использоваться двумя способами:

{% extends "base.html" %} (с кавычками) использует буквальное значение "base.html" в качестве названия родительского шаблона.
{% extends variable %} использует значение variable. Если значение строка, Django использует ее как название родительского шаблона. Если значение переменной объект Template, Django использует этот объект как родительский шаблон.

Смотрите подробности в Наследование шаблонов.

filter¶

Применяет фильтры к содержимому блока.

Можно передавать группу фильтров и они могут содержать фильтры – синтаксис аналогичен выводу переменных в шаблоне.

Примеры использования:

{% filter force_escape|lower %}
    This text will be HTML-escaped, and will appear in all lowercase.
{% endfilter %}

Примечание

Нельзя передавать фильтры escape и safe. Вместо этого используйте тег autoescape.

firstof¶

Выводит первую из переданных переменных, которая не равна False. НЕ экранирует значения переменных.

Ничего не выводит, если все переменные равны False.

Примеры использования:

{% firstof var1 var2 var3 %}

Это равносильно:

{% if var1 %}
    {{ var1|safe }}
{% else %}{% if var2 %}
    {{ var2|safe }}
{% else %}{% if var3 %}
    {{ var3|safe }}
{% endif %}{% endif %}{% endif %}

Вы можете использовать сроку как значение по-умолчанию на случай, если все переменные равны False:

{% firstof var1 var2 var3 "fallback value" %}

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

{% filter force_escape %}
    {% firstof var1 var2 var3 "fallback value" %}
{% endfilter %}

for¶

Цикл по каждому элементу массива. Например, выведем список спортсменов из athlete_list:

<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% endfor %}
</ul>

Вы можете использовать цикл по списку в обратном порядке {% for obj in list reversed %}.

Если вам нужен цикл по списку списков, вы можете распаковать значения под-списка на отдельные переменные. Например, если ваш контекст содержит список (x,y) координат points, вы можете использовать следующий код для их вывода:

{% for x, y in points %}
    There is a point at {{ x }},{{ y }}
{% endfor %}

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

{% for key, value in data.items %}
    {{ key }}: {{ value }}
{% endfor %}

Внутри цикла доступные некоторые дополнительные переменные:

Переменная	Описание
`forloop.counter`	Номер текущей итерации цикла начиная с 1
`forloop.counter0`	Номер текущей итерации цикла начиная с 0
`forloop.revcounter`	Номер текущей итерации цикла начиная с конца с 1
`forloop.revcounter0`	Номер текущей итерации цикла начиная с конца с 0
`forloop.first`	`True`, если это первая итерация
`forloop.last`	`True`, если это последняя итерация
`forloop.parentloop`	Для вложенных циклов, это “внешний” цикл.

for ... empty¶

Тег for содержит необязательную часть {% empty %}, которая будет отображена, если список пуст или не найден:

<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% empty %}
    <li>Sorry, no athlete in this list!</li>
{% endfor %}
<ul>

Это эквивалентно, но короче, читабельней и возможно быстрее, такому коду:

<ul>
  {% if athlete_list %}
    {% for athlete in athlete_list %}
      <li>{{ athlete.name }}</li>
    {% endfor %}
  {% else %}
    <li>Sorry, no athletes in this list.</li>
  {% endif %}
</ul>

if¶

Тег {% if %} вычисляет переменную и если она равна “true” (то есть существует, не пустая и не равна “false”) выводит содержимое блока:

{% if athlete_list %}
    Number of athletes: {{ athlete_list|length }}
{% elif athlete_in_locker_room_list %}
    Athletes should be out of the locker room soon!
{% else %}
    No athletes.
{% endif %}

В примере выше, если athlete_list не пустой, будет отображено количество спортсменов {{ athlete_list|length }}.

Как вы можете видеть, тег if может содержать один или несколько блоков `` {% elif %}``, так же как и блок {% else %}, который будет выведен, если все предыдущие условия не верны. Все эти блоки не обязательны.

Добавлено в Django 1.4: Пожалуйста, обратитесь к описанию релиза

Тег if теперь поддерживает блок {% elif %}.

Булевы операторы¶

Тег if может использовать and, or или not:

{% if athlete_list and coach_list %}
    Both athletes and coaches are available.
{% endif %}

{% if not athlete_list %}
    There are no athletes.
{% endif %}

{% if athlete_list or coach_list %}
    There are some athletes or some coaches.
{% endif %}

{% if not athlete_list or coach_list %}
    There are no athletes or there are some coaches (OK, so
    writing English translations of boolean logic sounds
    stupid; it's not our fault).
{% endif %}

{% if athlete_list and not coach_list %}
    There are some athletes and absolutely no coaches.
{% endif %}

Изменено в Django 1.2: Пожалуйста, обратитесь к описанию релиза

Можно использовать and и or вместе, операция and имеет больший приоритет чем or, например:

{% if athlete_list and coach_list or cheerleader_list %}

будет интерпретировано как:

if (athlete_list and coach_list) or cheerleader_list

Использовать скобки в теге if нельзя. Если вам нужно указать приоритет, используйте вложенные теги if.

Добавлено в Django 1.2: Пожалуйста, обратитесь к описанию релиза

Тег if может использовать операторы ==, !=, <, >, <=, >= и in которые работают таким образом:

Оператор `==`¶

Равенство. Например:

{% if somevar == "x" %}
  This appears if variable somevar equals the string "x"
{% endif %}

Оператор `!=`¶

Неравенство. Например:

{% if somevar != "x" %}
  This appears if variable somevar does not equal the string "x",
  or if somevar is not found in the context
{% endif %}

Оператор `<`¶

Меньше чем. Например:

{% if somevar < 100 %}
  This appears if variable somevar is less than 100.
{% endif %}

Оператор `>`¶

Больше чем. Например:

{% if somevar > 0 %}
  This appears if variable somevar is greater than 0.
{% endif %}

Оператор `<=`¶

Меньше чем или равно. Например:

{% if somevar <= 100 %}
  This appears if variable somevar is less than 100 or equal to 100.
{% endif %}

Оператор `>=`¶

Больше чем или равно. Например:

{% if somevar >= 1 %}
  This appears if variable somevar is greater than 1 or equal to 1.
{% endif %}

Оператор `in`¶

Вхождение в. Этот оператор поддерживается большинством контейнеров Python, что бы проверит входит ли значение в контейнер. Несколько примеров как работает x in y:

{% if "bc" in "abcdef" %}
  This appears since "bc" is a substring of "abcdef"
{% endif %}

{% if "hello" in greetings %}
  If greetings is a list or set, one element of which is the string
  "hello", this will appear.
{% endif %}

{% if user in users %}
  If users is a QuerySet, this will appear if user is an
  instance that belongs to the QuerySet.
{% endif %}

Оператор `not in`¶

Не вхождение в. Оператор обратный оператору in.

Операторы сравнения не могут использовать вместе как в Python или математике. Например, вместо использования:

{% if a > b > c %}  (WRONG)

вы должны использовать:

{% if a > b and b > c %}

Фильтры¶

Вы можете использовать фильтры в выражении if. Например:

{% if messages|length >= 100 %}
   You have lots of messages today!
{% endif %}

Сложные выражения¶

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

or
and
not
in
==, !=, <, >, <=, >=

(Это точно повторяет Python). Таким образом, например, следующий сложный тег if:

{% if a == b or c == d and e %}

...будет интерпретирован как:

(a == b) or ((c == d) and e)

Если вам нужен другой приоритет, используйте вложенные теги if. Иногда этот способ более понятен, во всяком случае, для тех, кто не знает правил приоритета.

ifchanged¶

Проверяет было ли изменено значение с предыдущей итерации цикла.

Блочный тег {% ifchanged %} используется внутри цикла. Существует два способа использовать тег.

Проверять содержимое тега и если оно было изменено с последней итерации, отображать его. Например, этот код отображает список дней и отображает месяц только при его изменении:
```
<h1>Archive for {{ 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 %}.

Аргументом может быть строка:

{% ifequal user.username "adrian" %}
    ...
{% endifequal %}

Вы можете сравнивать переменные шаблона или строки. Вы не можете сравнивать с объектами Python такими как True или False. Если вам нужно проверить что-то на истинность, используйте тег if.

Добавлено в Django 1.2: An alternative to the ifequal tag is to use the if tag and the == operator.

ifnotequal¶

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

Добавлено в Django 1.2: An alternative to the ifnotequal tag is to use the if tag and the != operator.

include¶

Загружает шаблон и выводит его с текущим контекстом. Это способ “включить” один шаблон в другой.

Названия шаблона можно указать переменной или строкой в одинарных или двойных кавычках.

Это пример включает содержимое шаблона "foo/bar.html":

{% include "foo/bar.html" %}

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

{% include template_name %}

Включенный шаблон выполняется с контекстом шаблона, который его включает. Этот пример выводит "Hello, John":

Контекст: переменная person равна "john".
Шаблон:
```
{% include "name_snippet.html" %}
```

Шаблон name_snippet.html:

{{ greeting }}, {{ person|default:"friend" }}!

Изменено в Django 1.3: Additional context and exclusive context.

Вы можете передать дополнительные переменные контекста в шаблон используя именованные аргументы:

{% include "name_snippet.html" with person="Jane" greeting="Hello" %}

Если вы хотите выполнить шаблон используя только указанные переменные в контексте (или не используя переменные совсем), добавите параметр only:

{% include "name_snippet.html" with greeting="Hi" only %}

Примечание

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

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

load¶

Загружает библиотеку тегов.

Например, следующий шаблон загрузил бы все теги и фильтры зарегистрированные в somelibrary и otherlibrary который находится в пакете package:

{% load somelibrary package.otherlibrary %}

Изменено в Django 1.3: Пожалуйста, обратитесь к описанию релиза

Вы можете так же загрузить определенные теги и фильтры из библиотеки, используя аргумент from. В этом примере, шаблонные теги/фильтры foo и bar будут загружены с somelibrary:

{% load foo bar from somelibrary %}

Смотрите раздел о собственных библиотеках фильтров и тегов.

now¶

Отображает текущую дату и/или время, используя формат соответственно переданной строке. Эта строка может содержать символы форматирования описанные в разделе о фильтре date.

Например:

It is {% now "jS F Y H:i" %}

Вы можете экранировать символ форматирования с помощью слэша, что бы использовать его как строку. В этом примере, “f” экранирован, т.к. в другом случае “f” будет использован как строка форматирования отображающая время. Символ “o” не экранирован т.к. это не символ форматирования:

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

Этот пример выведет “It is the 4th of September”.

Изменено в Django 1.4: Пожалуйста, обратитесь к описанию релиза

Примечание

Переданный формат может быть так же одним из предопределенных DATE_FORMAT, DATETIME_FORMAT, SHORT_DATE_FORMAT или SHORT_DATETIME_FORMAT. Предопределенные форматы зависят от текущего языка и настройки Формат локализации, например:

It is {% now "SHORT_DATETIME_FORMAT" %}

regroup¶

Группирует объекты по общему атрибуту.

Этот сложный тег лучше всего объяснить с помощью примера: people – список людей представленный словарями с ключами first_name, last_name и gender:

people = [
    {'first_name': 'George', 'last_name': 'Bush', 'gender': 'Male'},
    {'first_name': 'Bill', 'last_name': 'Clinton', 'gender': 'Male'},
    {'first_name': 'Margaret', 'last_name': 'Thatcher', 'gender': 'Female'},
    {'first_name': 'Condoleezza', 'last_name': 'Rice', 'gender': 'Female'},
    {'first_name': 'Pat', 'last_name': 'Smith', 'gender': 'Unknown'},
]

...и вам нужно отобразить список отсортированный по полу:

Male:
- George Bush
- Bill Clinton
Female:
- Margaret Thatcher
- Condoleezza Rice
Unknown:
- Pat Smith

Вы можете использовать тег {% regroup %} что бы сгруппировать список по полу(gender). Следующий шаблон делает это:

{% 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 – значение, по которому происходила группировка (например, строка “Male” или “Female”).
list – список объектов в группе (например, список всех людей с gender='Male').

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

people = [
    {'first_name': 'Bill', 'last_name': 'Clinton', 'gender': 'Male'},
    {'first_name': 'Pat', 'last_name': 'Smith', 'gender': 'Unknown'},
    {'first_name': 'Margaret', 'last_name': 'Thatcher', 'gender': 'Female'},
    {'first_name': 'George', 'last_name': 'Bush', 'gender': 'Male'},
    {'first_name': 'Condoleezza', 'last_name': 'Rice', 'gender': 'Female'},
]

В результате применения тега {% regroup %} для списка выше получим такой результат:

Male:
- Bill Clinton
Unknown:
- Pat Smith
Female:
- Margaret Thatcher
Male:
- George Bush
Female:
- Condoleezza Rice

Самый простой способ решить эту проблему удостоверится, что данные отсортированы так, как должны быть отображены.

Еще один способ отсортировать в шаблоне используя фильтр dictsort, если ваши данные это список словарей:

{% regroup people|dictsort:"gender" by gender as gender_list %}

Группировка по другим свойствам¶

Можно группировать объекты по методу, атрибуту, ключу словаря и списку объектов, в общем по всему, к чему можно получить доступ в шаблоне. Например, если “gender” это внешний ключ на модель с атрибутом “description,” вы можете использовать:

{% regroup people by gender.description as gender_list %}

Или, если gender это поле с choices, будет доступен метод django.db.models.Model.get_FOO_display() позволяя сгруппировать по отображаемым названиям, а не значениям choices:

{% regroup people by get_gender_display as gender_list %}

{{ gender.grouper }} теперь будет отображать значение поля, а не ключи choices.

spaceless¶

Убирает пробелы между HTML тегами, включая символы табуляции и перенос строки.

Пример использования:

{% spaceless %}
    <p>
        <a href="foo/">Foo</a>
    </p>
{% endspaceless %}

Этот пример вернет такой HTML:

<p><a href="foo/">Foo</a></p>

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

{% spaceless %}
    <strong>
        Hello
    </strong>
{% endspaceless %}

ssi¶

Выводит содержимое файла в шаблон.

Как и тег include, {% ssi %} добавляет содержимое другого файла, который должен быть указан через абсолютный путь, в текущий шаблон:

{% ssi /home/html/ljworld.com/includes/right_generic.html %}

Если используется не обязательный параметр “parsed”, содержимое включаемого файла будет выполнено как код шаблона используя текущий контекст:

{% ssi /home/html/ljworld.com/includes/right_generic.html parsed %}

Если вы используете {% ssi %}, определите параметр ALLOWED_INCLUDE_ROOTS в настройках Django, в качестве меры безопасности.

Смотрите так же: {% include %}.

Forwards compatibility

Изменено в Django 1.3: Пожалуйста, обратитесь к описанию релиза

В Django 1.5, поведение тега ssi будет изменено и будет принимать переменную контекста, а не значение без кавычек.

Для простоты обновления версии Django, в версию 1.3 добавлена версия тега в библиотеку future, которая поддерживает новое поведение. Что бы использовать этот тег, добавьте вызов тега load в начале шаблона, и заключите в кавычки первый аргумент тега ssi. Например:

{% load ssi from future %}
{% ssi '/home/html/ljworld.com/includes/right_generic.html' %}

В Django 1.5 тег будет заменен версией из библиотеки тегов future. Для простоты обновления Django используйте новый синтаксис.

templatetag¶

Выводит один из символов, которые используются для определения тегов.

Так как система шаблонов не поддерживает “экранирование”, для отображения элементов синтаксиса необходимо использовать тег {% templatetag %}.

Аргумент указывает какой элемент синтаксиса отображать:

Аргумент	Вывод
`openblock`	`{%`
`closeblock`	`%}`
`openvariable`	`{{`
`closevariable`	`}}`
`openbrace`	`{`
`closebrace`	`}`
`opencomment`	`{#`
`closecomment`	`#}`

url¶

Возвращает абсолютную ссылку (URL без имени домена) соответствующую указанному представлению с необязательными аргументами. Этот способ выводить ссылки, без “хардкодинга” в шаблоне, что бы не нарушать принцип DRY:

{% url path.to.some_view v1 v2 %}

Первый аргумент это путь к представлению в формате package.package.module.function. Дополнительные аргументы не обязательны. Это значения разделенные пробелами, которые будут использоваться как аргументы при формировании URL. Пример выше использует позиционные аргументы. Так же можно использовать именованные аргументы:

{% url path.to.some_view arg1=v1 arg2=v2 %}

Нельзя использовать и позиционные и именованные аргументы в одно теге. Все обязательные аргументы URLconf должны быть указаны.

Например, мы имеем представление, app_views.client, чей URLconf принимает ID клиента (client() это метод в файле app_views.py). URLconf может выглядеть таким образом:

('^client/(\d+)/$', 'app_views.client')

Если URLconf приложения добавлен в URLconf проекта:

('^clients/', include('project_name.app_name.urls'))

...в шаблоне можно создать ссылку на представление:

{% url app_views.client client.id %}

Тег вернет такую строку /clients/client/123/.

Если вы используете именованные шаблоны URL, можно указать имя шаблона в теге url вместо пути к представлению.

Если вы пытаетесь вывести URL который не существует, будет вызвано исключение django.core.urlresolvers.NoReverseMatch, и ваш сайт покажет страницу с ошибкой.

Если вам нужно получить URL без его отображения:

{% url path.to.view arg arg2 as the_url %}

<a href="{{ the_url }}">I'm linking to {{ the_url }}</a>

Такой {% url ... as var %} синтаксис не вызовет исключение, если представление отсутствует. На практике вы будете использовать его для отображения ссылок на необязательные представления:

{% url path.to.view as the_url %}
{% if the_url %}
  <a href="{{ the_url }}">Link to optional stuff</a>
{% endif %}

Если вы хотите использовать URL с указанным пространством имен, укажите полное имя:

{% url myapp:view-name %}

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

Изменено в Django 1.2: Пожалуйста, обратитесь к описанию релиза

Для обратной совместимости, тег {% url %} поддерживает старый синтаксис разделения аргументов запятыми. Вы не должны его использовать в новых проектах. Для тех, кому интересно, пример как он выглядит:

{% url path.to.view arg,arg2 %}
{% url path.to.view arg, arg2 %}

Этот синтаксис не поддерживает использование запятых и знака равно в аргументах.

Forwards compatibility

Изменено в Django 1.3: Пожалуйста, обратитесь к описанию релиза

В Django 1.5 поведение тега url будет изменено, первый аргумент будет переменной контекста, а не название шаблона URL без кавычек.

Для простоты обновления версии Django, в версию 1.3 добавлена версия тега в библиотеку future, которая поддерживает новое поведение. Что бы использовать этот тег, добавьте вызов тега load в начале шаблона, и заключите в кавычки первый аргумент тега url. Например:

{% load url from future %}


{% url 'app_views.client' %}

{% url 'myapp:view-name' %}

{% with view_path="app_views.client" %}
{% url view_path client.id %}
{% endwith %}

{% with url_name="client-detail-view" %}
{% url url_name client.id %}
{% endwith %}

Новый тег так же не поддерживает разделение аргументов url запятыми.

В Django 1.5 тег будет заменен версией из библиотеки тегов future. Для простоты обновления Django используйте новый синтаксис.

widthratio¶

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

Например:

<img src="bar.gif" height="10" width="{% widthratio this_value max_value 100 %}" />

Если this_value равно 175 и max_value равно 200, изображение из примера выше будет шириной 88 пикселей (так как 175/200 = .875; .875 * 100 = 87.5 что приблизительно равно 88).

with¶

Изменено в Django 1.3: New keyword argument format and multiple variable assignments.

Кэширует сложные переменные под простым названием. Это полезно при использовании “тяжелых” методов (например, тех, которые выполняют запрос к базе данных) несколько раз.

Например:

{% with total=business.employees.count %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

Указанная переменная (в примере выше, total) доступна только между тегами {% with %} и {% endwith %}.

Вы можете указать больше одной переменной контекста:

{% with alpha=1 beta=2 %}
    ...
{% endwith %}

Примечание

Предыдущий синтаксис так же работает: {% with business.employees.count as total %}

Список встроенных фильтров¶

add¶

Суммирует аргумент и значение.

Например:

{{ value|add:"2" }}

Если value равно 4, будет выведено 6.

Изменено в Django 1.2: The following behavior didn’t exist in previous Django versions.

Фильтр попытается преобразовать оба значения в целое число. Если это не удастся, он будет пытаться добавить значения в любом случае. Это работает для некоторых типов (строки, списки и др.) и не работает с другими. Если ничего не получится, будет выведена пустая строка.

Например, у нас есть:

{{ first|add:second }}

и first равно [1, 2, 3] и second равно [4, 5, 6], тогда результат будет [1, 2, 3, 4, 5, 6].

Предупреждение

Строки, которые могут быть преобразованы в числа, будут суммированы, а не объединены, как показано в примере выше.

addslashes¶

Добавляет слэш перед кавычкой. Удобно при экранировании строк в CSV, например.

Например:

{{ value|addslashes }}

Если value равно "I'm using Django", результат будет "I\'m using Django".

capfirst¶

Делает заглавным первый символ значения.

Например:

{{ value|capfirst }}

Если value равно "django", результат будет "Django".

center¶

Центрирует значение в поле заданной ширины.

Например:

"{{ value|center:"15" }}"

Если value равно "django", результат будет " Django ".

cut¶

Удаляет значение аргумента из строки, к которой применяется фильтр.

Например:

{{ value|cut:" "}}

Если value равно "String with spaces", результат будет "Stringwithspaces".

date¶

Форматирует дату в соответствии с указанным форматом.

Использует формат функции date() в PHP (http://php.net/date) с небольшими отличиями.

Доступное форматирование:

Символ форматирования	Описание	Пример вывода
a	`'a.m.'` или `'p.m.'` (немного отличается от функции PHP, так как отображает в стиле Associated Press.)	`'a.m.'`
A	`'AM'` или `'PM'`.	`'AM'`
b	Название месяца, 3-х буквенное, в нижнем регистре.	`'jan'`
B	Не используется.
c	ISO 8601 формат. (Заметим: в отличии от других форматов, таких как “Z”, “O” или “r”, формат “c” не добавит временную зону для относительного времени (смотрите `datetime.tzinfo`).	`2008-01-02T10:30:00.000123+02:00`, или `2008-01-02T10:30:00.000123` если время относительное
d	День месяца, 2 цифры с ведущим нулем.	От `'01'` до `'31'`
D	День недели, 3-х буквенное текстовое название.	`'Fri'`
e	Название временной зоны. Может быть в любом формате, или вернуть пустую строку в зависимости от объекта даты.	`''`, `'GMT'`, `'-500'`, `'US/Eastern'` и др.
E	Название месяца, зависит от текущего языка. Используется для отображения полного называния даты.	`'listopada'` (для польского языка, не `'Listopad'`)
f	Время, час в 12-часовом формате и минуты, минуты не отображаются если равны нулю. Собственное расширение.	`'1'`, `'1:30'`
F	Название месяца, текстовое, длинное.	`'January'`
g	Час, 12-часовом формате без ведущих нулей.	От `'1'` до `'12'`
G	Час, 24-часовой формат	От `'0'` до `'23'`
h	Час, 12-часовой формат.	От `'01'` до `'12'`
H	Час, 24-часовой формат.	От `'00'` до `'23'`
i	Минуты.	От `'00'` до `'59'`
I	Не используется.
j	День месяца без ведущего нуля.	От `'1'` до `'31'`
l	Название дня недели, текстовое, длинное.	`'Friday'`
L	Булево значение указывающее високосный ли год.	`True` или `False`
m	Месяц, 2-цифирный с ведущими нулями.	От `'01'` до `'12'`
M	Название месяца, текстовое, 3-х буквенное.	`'Jan'`
n	Номер месяца без ведущего нуля.	От `'1'` до `'12'`
N	Аббревиатура названия месяца в формате Associated Press. Собственное расширение.	`'Jan.'`, `'Feb.'`, `'March'`, `'May'`
o	week-numbering год в соответствии с ISO-8601	`'1999'`
O	Разница с временем по Гринвичу	`'+0200'`
P	Время, в 12-часовом формате, минуты и ‘a.m.’/’p.m.’, минуты упускаются если равны нулю, значения ‘midnight’ и ‘noon’ используются по возможности. Собственное расширение.	`'1 a.m.'`, `'1:30 p.m.'`, `'midnight'`, `'noon'`, `'12:30 p.m.'`
r	Дата в формате RFC 2822.	`'Thu, 21 Dec 2000 16:01:07 +0200'`
s	Секунды, 2-цифирный формат без ведущих нулей.	От `'00'` до `'59'`
S	Английский суффикс для дня месяца, 2 символа.	`'st'`, `'nd'`, `'rd'` или `'th'`
t	Количество дней в месяце.	От `28` до `31`
T	Часовой пояс сервера.	`'EST'`, `'MDT'`
u	микросекунды	От `0` до `999999`
U	Секунды с начала эпохи Unix (1 января 1970 00:00:00 UTC).
w	Номер дня недели, без ведущих нулей.	от `'0'` (воскресение) до `'6'` (субота)
W	Норме недели в году в соответствии с ISO-8601, первая неделя начинается с понедельника.	`1`, `53`
y	Год, 2 цифры.	`'99'`
Y	Год, 4 цифры.	`'1999'`
z	Номер дня в году.	От `0` до `365`
Z	Смещения часового пояса в секундах. Для часового пояса западнее UTC значение будет отрицательным, для тех, что восточнее UTC – положительным.	От `-43200` до `43200`

Добавлено в Django 1.2: Пожалуйста, обратитесь к описанию релиза

Форматирование c и u добавлены в Django 1.2.

Добавлено в Django 1.4: Пожалуйста, обратитесь к описанию релиза

Форматирование e и o добавлены в Django 1.4.

Например:

{{ value|date:"D d M Y" }}

Если value равно объекту datetime (например, результат выполнения datetime.datetime.now()), будет выведено значение 'Wed 09 Jan 2008'.

Переданный формат может быть одним из предопределенных(DATE_FORMAT, DATETIME_FORMAT, SHORT_DATE_FORMAT или SHORT_DATETIME_FORMAT) или любой другой сформированный из символов форматирования из таблицы выше. Предопределенные форматы зависят от текущего языка и настройки Формат локализации, например:

Предположим что USE_L10N равно True и LANGUAGE_CODE равно "es", тогда:

{{ value|date:"SHORT_DATE_FORMAT" }}

результат вывода будет "09/01/2008" (формат "SHORT_DATE_FORMAT" для языка es указан в Django как "d/m/Y").

Если форматирование не указано:

{{ value|date }}

...будет использовано значение из настройки DATE_FORMAT без учета текущего языка.

Изменено в Django 1.2: Predefined formats can now be influenced by the current locale.

default¶

Если значение равно False, будет использовано значение по-умолчанию. В противном случае используется значение.

Например:

{{ value|default:"nothing" }}

Если value равно "" (пустая строка), будет выведено nothing.

default_if_none¶

Если (и только в этом случае) значение равно None, будет использовано значение по-умолчанию. В противном случае используется значение.

Заметим, если передана пустая строка, значение по-умолчанию не будет использовано. Используйте фильтр default, если нужно учитывать пустую строку.

Например:

{{ value|default_if_none:"nothing" }}

Если value равно None, будет выведено "nothing".

dictsort¶

Принимает список словарей и возвращает список отсортированный по указанному ключу.

Например:

{{ value|dictsort:"name" }}

Если value равно:

[
    {'name': 'zed', 'age': 19},
    {'name': 'amy', 'age': 22},
    {'name': 'joe', 'age': 31},
]

будет возвращено:

[
    {'name': 'amy', 'age': 22},
    {'name': 'joe', 'age': 31},
    {'name': 'zed', 'age': 19},
]

dictsortreversed¶

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

divisibleby¶

Возвращает True, если значение делится на аргумент.

Например:

{{ value|divisibleby:"3" }}

Если value равно 21, будет возвращено True.

escape¶

Экранирует HTML. В частности выполняются такие замены:

< заменяется на <
> заменяется на >
' (одинарная кавычка) заменяется на '
" (двойная кавычка) заменяется на "
& заменяется на &

Экранирование применяется к выводимой строке, и нет разницы где в цепочке фильтров будет добавлен escape: он всегда будет применяться так, как будто это последний фильтр. Если экранирование необходимо сразу применить, используйте фильтр force_escape.

Применение escape к переменной, которая уже была экранирована с помощью авто-экранирования, безопасно. Будет применено только одно экранирование. Так что безопасно использовать его с авто-экранированием. Если вам нужно применить экранирование несколько раз, используйте force_escape.

escapejs¶

Экранирует символы в строке, используемой в JavaScript. Это не делает сроку безопасной для использования в HTML, но защищает от синтаксических ошибок при генерации JavaScript/JSON.

Например:

{{ value|escapejs }}

Если value равно "testing\r\njavascript \'string" <b>escaping</b>", будет выведено "testing\\u000D\\u000Ajavascript \\u0027string\\u0022 \\u003Cb\\u003Eescaping\\u003C/b\\u003E".

filesizeformat¶

Форматирует размер файла в читабельном формате (например. '13 KB', '4.1 MB', '102 bytes' и др.).

Например:

{{ value|filesizeformat }}

Если value равно 123456789, будет выведено 117.7 MB.

first¶

Возвращает первый элемент списка.

Например:

{{ value|first }}

Если value равно ['a', 'b', 'c'], будет возвращено 'a'.

fix_ampersands¶

Примечание

Этот фильтр редко когда полезен т.к. символ амперсанда экранируется автоматически . Смотрите escape.

Заменяет амперсанд &.

Например:

{{ value|fix_ampersands }}

Если value равно Tom & Jerry, будет возвращено Tom & Jerry.

Однако, амперсанд в словах не будет заменен. Например, если value равно Café, вывод будет не Caf&eacute; а останется Café. Это означает, что в некоторых случаях, например сокращение с последующей точкой с запятой, фильтр не заменит амперсанд. Например, если value равно Contact the R&D;, вывод будет без замены &D;.

floatformat¶

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

`value`	Шаблон	Вывод
`34.23234`	`{{ value\|floatformat }}`	`34.2`
`34.00000`	`{{ value\|floatformat }}`	`34`
`34.26000`	`{{ value\|floatformat }}`	`34.3`

Если используется целочисленный аргумент, floatformat округляет до указанного количества знаков после запятой. Например:

`value`	Шаблон	Вывод
`34.23234`	`{{ value\|floatformat:3 }}`	`34.232`
`34.00000`	`{{ value\|floatformat:3 }}`	`34.000`
`34.26000`	`{{ value\|floatformat:3 }}`	`34.260`

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

`value`	Шаблон	Вывод
`34.23234`	`{{ value\|floatformat:"-3" }}`	`34.232`
`34.00000`	`{{ value\|floatformat:"-3" }}`	`34`
`34.26000`	`{{ value\|floatformat:"-3" }}`	`34.260`

Использование floatformat без аргументов эквивалентно floatformat с -1.

force_escape¶

Применяет экранирование HTML к строке (смотрите escape). Это фильтр применяется сразу и возвращает новую экранированную строку. Это полезно в редких случаях, если вам необходимо применить экранирование несколько раз, или если необходимо применить другие фильтры в экранированной строке.

get_digit¶

Принимает число и возвращает запрашиваемую цифру, где 1 самая правая цифра, 2 - вторая с права, и тд. Возвращает оригинальное значение, если оно не верно (не число или меньше 1). В противном случае, всегда выводится целое число.

Например:

{{ value|get_digit:"2" }}

Если value равно 123456789, будет выведено 8.

iriencode¶

Конвертирует IRI (Internationalized Resource Identifier) в строку, которая может быть использована в URL. Это необходимо, если вы хотите использовать не ASCII символы в URL.

Можно использовать этот фильтр после использования фильтра urlencode.

Например:

{{ value|iriencode }}

Если value равно "?test=1&me=2", вывод будет "?test=1&me=2".

join¶

Объединяет список используя указанную строку, аналог str.join(list) в Python

Например:

{{ value|join:" // " }}

Если value равно списку ['a', 'b', 'c'], вывод будет "a // b // c".

last¶

Возвращает последний элемент списка.

Например:

{{ value|last }}

Если value равно ['a', 'b', 'c', 'd'], выведет "d".

length¶

Возвращает размер значения. Работает для строк и списков.

Например:

{{ value|length }}

Если value равно ['a', 'b', 'c', 'd'], выведет 4.

length_is¶

Возвращает True, если размер значения равен аргументу, и False в противном случае.

Например:

{{ value|length_is:"4" }}

Если value равно ['a', 'b', 'c', 'd'], вернет True.

linebreaks¶

Заменяет переносы строки аналогами из HTML; один перенос строки будет заменен на <br />, новая строка с предыдущей пустой строкой оборачиваются в тег </p>.

Например:

{{ value|linebreaks }}

Если value равно Joel\nis a slug, вывод будет <p>Joel<br />is a slug</p>.

linebreaksbr¶

Заменяет все переносы строки на <br />.

Например:

{{ value|linebreaksbr }}

Если value равно Joel\nis a slug, вывод будет Joel<br />is a slug.

linenumbers¶

Отображает текст с номерами строк.

Например:

{{ value|linenumbers }}

Если value равно:

one
two
three

вернет:

one
two
three

ljust¶

Выравнивает значение влево в поле указанной ширины.

Аргумент: размер поля

Например:

"{{ value|ljust:"10" }}"

Если value равно Django, выведет "Django ".

lower¶

Конвертирует строку в нижний регистр.

Например:

{{ value|lower }}

Если value равно Still MAD At Yoko, выведет still mad at yoko.

make_list¶

Превращает значение в список. Для строк это будет список символов. Число сначала конвертируется в unicode, а потом в список.

Например:

{{ value|make_list }}

Если value равно строке "Joel", будет возвращен список [u'J', u'o', u'e', u'l']. Если value равно 123, вернет список [u'1', u'2', u'3'].

phone2numeric¶

Преобразует телефонный номер (возможно, содержащий буквы) в его числовой эквивалент.

Значение не должно быть правильным телефонным номером, будет преобразована любая строка.

Например:

{{ value|phone2numeric }}

Если value равно 800-COLLECT, выведет 800-2655328.

pluralize¶

Возвращает суффикс множественного числа, если значение не 1. По-умолчанию использует суффикс 's'.

Например:

You have {{ num_messages }} message{{ num_messages|pluralize }}.

Если num_messages равно 1, выведет You have 1 message. Если num_messages равно 2 выведет You have 2 messages.

Для слов, которые используют суффикс отличный от 's', вы можете указать его как аргумент.

Например:

You have {{ num_walruses }} walrus{{ num_walruses|pluralize:"es" }}.

Для слов, которые не преобразуются в множественную форму добавлением суффикса, вы можете указать как одинарный так и множественный суффиксы, разделенные запятыми.

Например:

You have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.

Примечание

Используйте blocktrans для переводимых строк.

pprint¶

“Врапер” для pprint.pprint() – используется для отладки.

random¶

Возвращает случайный элемент из списка.

Например:

{{ value|random }}

Если value равно ['a', 'b', 'c', 'd'], вернет "b".

removetags¶

Удаляет [X]HTML теги. Теги указываются через пробел в качестве аргументов.

Например:

{{ value|removetags:"b span"|safe }}

Если value равно "<b>Joel</b> <button>is</button> a <span>slug</span>", будет возвращено "Joel <button>is</button> a slug".

Этот фильтр регистрозависимый.

Если value равно "<B>Joel</B> <button>is</button> a <span>slug</span>", будет выведено "<B>Joel</B> <button>is</button> a slug".

rjust¶

Выравнивает значение вправо в поле указанной ширины.

Аргумент: размер поля

Например:

"{{ value|rjust:"10" }}"

Если value равно Django, вернет " Django".

safe¶

Помечает строку, как требующую последующего HTML экранирования. Если авто-экранирование отключено, этот фильтр ничего не изменит.

Примечание

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

{{ var|safe|escape }}

safeseq¶

Применяет фильтр safe к каждому элементу последовательности. Полезно применять с другими тегами работающими с последовательностями, такими как join. Например:

{{ some_list|safeseq|join:", " }}

Вы не можете использовать фильтр safe в таком случае, так как он сначала преобразует значение в строку.

slice¶

Возвращает срез списка.

Используйте синтаксис срезов Python. Смотрите http://diveintopython.net/native_data_types/lists.html#odbchelper.list.slice.

Например:

{{ some_list|slice:":2" }}

Если some_list равно ['a', 'b', 'c'], вернет ['a', 'b'].

slugify¶

Конвертирует в нижний регистр, удаляет нетекстовые символы (все кроме букв, цифр и символов подчеркивания) и преобразует пробелы в дефисы. Так же удаляет пробелы в начале и в конце строки.

Например:

{{ value|slugify }}

Если value равно "Joel is a slug", вернет "joel-is-a-slug".

stringformat¶

Форматирует значение в соответствии с аргументом, который является спецификатором форматирования строк. Спецификатор использует синтаксис форматирования строк Python, с той лишь разницей, что ведущий символ “%” опущен.

Смотрите документацию Python о форматировании строк http://docs.python.org/library/stdtypes.html#string-formatting-operations

Например:

{{ value|stringformat:"s" }}

Если value равно "Joel is a slug", выведет "Joel is a slug".

striptags¶

Удаляет все [X]HTML теги.

Например:

{{ value|striptags }}

Если value равно "<b>Joel</b> <button>is</button> a <span>slug</span>", выведет "Joel is a slug".

time¶

Форматирует время в соответствии с указанным форматом.

Можно использовать предопределенный TIME_FORMAT, или собственный формат аналогичный формату описанному в date. Заметим, что предопределенный формат зависит от текущего языка.

Фильтр принимает только параметры в строке формата, которые относятся к времени, а не дате (по понятным причинам). Если вам нужно отформатировать дату, используйте фильтр date.

Например:

{{ value|time:"H:i" }}

Если value равно datetime.datetime.now(), может вернуть "01:23".

Другой пример:

Предположим USE_L10N равно True и LANGUAGE_CODE равно "de", тогда:

{{ value|time:"TIME_FORMAT" }}

будет возвращена строка "01:23:00" (формат "TIME_FORMAT" для языка de определен в Django как "H:i:s").

Если форматирование не указано:

{{ value|time }}

...будет использовано значение из настройки TIME_FORMAT без учета текущего языка.

Изменено в Django 1.2: Predefined formats can now be influenced by the current locale.

timesince¶

Форматирует дату как время прошедшее с момента другой даты (например, “4 days, 6 hours”).

Принимает не обязательный аргумент – дату, используемую как точку отсчета (без аргументов используется текущее время). Например, если blog_date это дата, равная полночи 1 июня 2006, и comment_date равен 08:00, 1 июня 2006, тогда {{ blog_date|timesince:comment_date }} вернет “8 часа”.

Сравнение абсолютной(с временной зоной) и относительной(без временной зоны) дат вернет пустую строку.

Минута - самая малая единица измерения, и для дат из будущего, относительно точки сравнения, возвращается “0 минут” .

timeuntil¶

Аналогичен timesince, только определяет время от текущей даты до указанной. Например, если сегодня 1 июня 2006 и conference_date это дата 29 июня 2006, тогда {{ conference_date|timeuntil }} вернет “4 недели”.

Принимает не обязательный аргумент – дату, используемую как точку отсчета (вместо текущего времени). Если from_date содержи 22 июня 2006, тогда {{ conference_date|timeuntil:from_date }} вернет “1 неделя”.

Сравнение абсолютной(с временной зоной) и относительной(без временной зоны) дат вернет пустую строку.

Минута - самая малая единица измерения, и для дат из прошлого, относительно точки сравнения, возвращается “0 минут” .

title¶

Конвертирует строку в заголовок

Например:

{{ value|title }}

Если value равно "my first post", вернет "My First Post".

truncatechars¶

Добавлено в Django 1.4: Пожалуйста, обратитесь к описанию релиза

Обрезает строку до указанной длины. Обрезанная строка будет оканчиваться троеточием(”...”).

Аргумент: длинна строки в символах

Например:

{{ value|truncatechars:9 }}

Если value равно "Joel is a slug", вернет "Joel i...".

truncatewords¶

Обрезает строку после указанного количества слов.

Аргумент: количество слов в строке

Например:

{{ value|truncatewords:2 }}

Если value равно "Joel is a slug", вернет "Joel is ...".

Переносы строки будут удалены.

truncatewords_html¶

Аналогичен truncatewords, но учитывает наличие HTML тегов. Теги, которые остались открыты в стоке после обрезания, будут немедленно закрыты.

Этот фильтр менее эффективен чем truncatewords, используйте его только с HTML-текстом.

Например:

{{ value|truncatewords_html:2 }}

Если value равно "<p>Joel is a slug</p>", вернет "<p>Joel is ...</p>".

Символы новой строки в содержимом будут сохранены.

unordered_list¶

Принимает вложенный список и возвращает неупорядоченный HTML список – БЕЗ открывающего и закрывающего <ul> тегов.

Предполагается, что список находится в нужном формате. Например, если var равен ['States', ['Kansas', ['Lawrence', 'Topeka'], 'Illinois']], тогда {{ var|unordered_list }} вернет:

<li>States
<ul>
        <li>Kansas
        <ul>
                <li>Lawrence</li>
                <li>Topeka</li>
        </ul>
        </li>
        <li>Illinois</li>
</ul>
</li>

Заметка: старый, более строгий и подробный формат, так же поддерживается: ['States', [['Kansas', [['Lawrence', []], ['Topeka', []]]], ['Illinois', []]]],

upper¶

Конвертирует строку в верхний регистр

Например:

{{ value|upper }}

Если value равно "Joel is a slug", будет возвращено "JOEL IS A SLUG".

urlencode¶

Экранирует значение для безопасного использования в URL.

Например:

{{ value|urlencode }}

Если value равно "http://www.example.org/foo?a=b&c=d", будет возвращено "http%3A//www.example.org/foo%3Fa%3Db%26c%3Dd".

Добавлено в Django 1.3: Пожалуйста, обратитесь к описанию релиза

Используй не обязательный аргумент, можно указать символы, который не должны быть экранированы.

Если аргумент не указан, символ ‘/’ предполагается как безопасный символ. Если необходимо экранировать все символы, передайте пустую строку. Например:

{{ value|urlencode:"" }}

Если value равно "http://www.example.org/", будет возвращено "http%3A%2F%2Fwww.example.org%2F".

urlize¶

Конвертирует URL-ы в тексте в “кликабельные” ссылки.

Этот тег конвертирует ссылки с префиксами http://, https://, или www.. Например, http://goo.gl/aia1t будет конвертирован, goo.gl/aia1t – нет.

Так же поддерживаются ссылки состоящие только из домена и заканчивающиеся на один из первоначальных доменов первого уровня (.com, .edu, .gov, .int, .mil, .net, and .org). Например, djangoproject.com будет преобразован.

Изменено в Django 1.4: Пожалуйста, обратитесь к описанию релиза

До Django 1.4, поддерживались только суффиксы .com, .net and .org.

Ссылки могут быть с завершающей пунктуацией (точка, запятая, закрывающая скобка) и предшествующей пунктуацией (открывающая скобка), urlize все корректно преобразует.

Ссылки созданные urlize содержат атрибут rel="nofollow".

Например:

{{ value|urlize }}

Если value равно "Check out www.djangoproject.com", будет выведено "Check out <a href="http://www.djangoproject.com" rel="nofollow">www.djangoproject.com</a>".

Фильтр urlize принимает не обязательный аргумент autoescape. Если autoescape равен True, текст ссылки и URL будут экранированы с помощью фильтра escape. Значение по-умолчанию для autoescape равно True.

Примечание

Если применить urlize к тексту, который содержит HTML, результат будет неверным. Применяйте фильтр только к обычному тексту.

urlizetrunc¶

Преобразует URL-ы в ссылки как и urlize, но обрезает название ссылок длиннее указанного предела.

Аргумент: Максимальное количество символов в названии ссылки, включая троеточие добавленное при обрезании текста.

Например:

{{ value|urlizetrunc:15 }}

Если value равно "Check out www.djangoproject.com", вернет 'Check out <a href="http://www.djangoproject.com" rel="nofollow">www.djangopr...</a>'.

Как и urlize, фильтр следует применять к обычному тексту.

wordcount¶

Возвращает количество слов.

Например:

{{ value|wordcount }}

Если value равно "Joel is a slug", верент 4.

wordwrap¶

“Оборачивает” слова до указанной длинны строки.

Аргумент: количество символов в строке

Например:

{{ value|wordwrap:5 }}

Если value равно Joel is a slug, вернет:

Joel
is a
slug

yesno¶

Для true, false и (опционально) None выводит строки “yes”, “no”, “maybe”, или другие, переданные как список значений, разделенный запятыми:

Например:

{{ value|yesno:"yeah,no,maybe" }}

Значение	Аргумент	Вывод
`True`		`yes`
`True`	`"yeah,no,maybe"`	`yeah`
`False`	`"yeah,no,maybe"`	`no`
`None`	`"yeah,no,maybe"`	`maybe`
`None`	`"yeah,no"`	`"no"` (конвертирует `None` в `False` если значение для `None` не указано)

Теги и фильтры для интернационализация¶

Django предоставляет теги и фильтры для управления интернационализацией в шаблонах. Они предоставляют контроль за переводом, форматированием и преобразованием часового пояса.

i18n¶

Эта библиотека позволяет определять переводимый текст в шаблонах. Для включения установите настройку USE_I18N в True, потом загрузите библиотеку добавив {% load i18n %} в шаблон.

Смотрите Интернационализация: в коде шаблонов.

l10n¶

Эта библиотека предоставляет контроль за локализацией значений в шаблонах. Просто загрузите библиотеку {% load l10n %}. Если установить USE_L10N в True, локализация будет активна по-умолчанию.

Смотрите Управление локализацией в шаблонах.

tz¶

Добавлено в Django 1.4: Пожалуйста, обратитесь к описанию релиза

Эта библиотека предоставляет возможность преобразовывать временные зоны в шаблонах. Как и l10n, просто загрузите библиотеку {% load tz %}. Но если установить USE_TZ в True, преобразование в локальное время будет происходить автоматически.

Смотрите Вывод объектов абсолютного времени в шаблонах.

Другие библиотеки тегов и фильтров¶

Django содержит несколько других библиотек тегов. Что бы их использовать, добавьте приложение в INSTALLED_APPS и загрузите библиотеку тегом {% load %}.

django.contrib.humanize¶

Набор фильтров для добавления “человечности” вашим данным. Смотрите django.contrib.humanize.

django.contrib.markup¶

Набор фильтров, которые реализуют распространенные языки разметки:

Textile
Markdown
reST (reStructuredText)

Смотрите документацию о markup.

django.contrib.webdesign¶

Набор тегов для разработки, например, генератор “Lorem Ipsum”. Смотрите django.contrib.webdesign.

static¶

Создает ссылку на файл в STATIC_ROOT. Вы можете применять его независимо от того, используете вы RequestContext или нет.

{% load static %}
<img src="{% static "images/hi.jpg" %}" />

Принимает в качестве аргументов переменные контекста, например, в шаблон передали переменную user_stylesheet:

{% load static %}
<link rel="stylesheet" href="{% static user_stylesheet %}" type="text/css" media="screen" />

Примечание

Приложение staticfiles содержит так же тег static, который использует настройку STATICFILES_STORAGE что бы построить URL к указанному файлу. Используйте его, если, например, вы используете облачный сервис для хранения файлов:

{% load static from staticfiles %}
<img src="{% static "images/hi.jpg" %}" />

get_static_prefix¶

Если вы не используете RequestContext, или вам необходимо больше контроля где и как использовать STATIC_URL в шаблоне, применяйте тег get_static_prefix:

{% load static %}
<img src="{% get_static_prefix %}images/hi.jpg" />

Есть другой способ, который позволяет использовать значение несколько раз в шаблоне:

{% load static %}
{% get_static_prefix as STATIC_PREFIX %}

<img src="{{ STATIC_PREFIX }}images/hi.jpg" />
<img src="{{ STATIC_PREFIX }}images/hi2.jpg" />

get_media_prefix¶

Подобно get_static_prefix, get_media_prefix предоставляет префикс медиа-файлов MEDIA_URL, например:

<script type="text/javascript" charset="utf-8">
var media_path = '{% get_media_prefix %}';
</script>

Django 1.4 documentation (читать 1.5)

Встроенные шаблонные теги и фильтры¶

Список встроенных тегов¶

autoescape¶

block¶

comment¶

csrf_token¶

cycle¶

debug¶

extends¶

filter¶

firstof¶

for¶

for ... empty¶

if¶

Булевы операторы¶

Оператор ==¶

Оператор !=¶

Оператор <¶

Оператор >¶

Оператор <=¶

Оператор >=¶

Оператор in¶

Оператор not in¶

Фильтры¶

Сложные выражения¶

ifchanged¶

ifequal¶

ifnotequal¶

include¶

load¶

now¶

regroup¶

Группировка по другим свойствам¶

spaceless¶

ssi¶

templatetag¶

url¶

widthratio¶

with¶

Список встроенных фильтров¶

add¶

addslashes¶

capfirst¶

center¶

cut¶

date¶

default¶

default_if_none¶

dictsort¶

dictsortreversed¶

divisibleby¶

escape¶

escapejs¶

filesizeformat¶

first¶

fix_ampersands¶

floatformat¶

force_escape¶

get_digit¶

iriencode¶

join¶

last¶

length¶

length_is¶

linebreaks¶

linebreaksbr¶

linenumbers¶

ljust¶

lower¶

make_list¶

phone2numeric¶

pluralize¶

pprint¶

random¶

removetags¶

rjust¶

safe¶

safeseq¶

slice¶

Оператор `==`¶

Оператор `!=`¶

Оператор `<`¶

Оператор `>`¶

Оператор `<=`¶

Оператор `>=`¶

Оператор `in`¶

Оператор `not in`¶