autoescape

控制当前的自动转义行为。此标记采用on或 off作为参数，并确定自动转义是否在块内生效。该块以endautoescape结束标记关闭。

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

block

定义可由子模板覆盖的块

comment

忽略之间的所有内容。可以在第一个标签中插入可选的注释。例如，在注释掉用于记录代码被禁用的原因的代码时，这非常有用。

<p>Rendered text with {{ pub_date|date:"c" }}</p>
{% comment "Optional note" %}
    <p>Commented out text with {{ create_date|date:"c" }}</p>
{% endcomment %}

csrf_token

此标记用于CSRF保护

cycle

每次遇到此标记时都会生成其中一个参数。第一个参数是在第一次遇到时产生的，第二个参数是在第二次遇到时产生的，依此类推。一旦所有参数都耗尽，标记将循环到第一个参数并再次生成它。(可以使用变量)

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

{% cycle 'row1' 'row2' as rowcolors %}
作为变量使用

debug

输出一整套调试信息，包括当前上下文和导入的模块。

extends

表示此模板扩展父模板的信号，可以继承变量和值，能够使用相对路径

filter

通过一个或多个过滤器过滤块的内容。可以使用管道指定多个过滤器，过滤器可以具有参数，就像在变量语法中一样。

请注意，该块包含和 标记之间的所有文本。filterendfilter

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

firstof

输出第一个不是的参数变量False。如果所有传递的变量都没有输出False。

{% firstof var1 var2 var3 %}

此标记自动转义变量值。您可以使用以下命令禁用自动转义

{% autoescape off %}
    {% firstof var1 var2 var3 "<strong>fallback value</strong>" %}
{% endautoescape %}

或者，如果只应转义某些变量，您可以使用：

{% firstof var1 var2|safe var3 "<strong>fallback value</strong>"|safe %}

您可以使用语法将输出存储在变量中。{% firstof var1 var2 var3 as value %}

for

循环遍历数组中的每个项目，使项目在上下文变量中可用

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

您可以使用反向循环遍历列表 。{% for obj in list reversed %}

如果您的上下文包含字典data，则以下内容将显示字典的键和值

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

for...... empty

该for标签可以使用一个可选条款，其文本显示，如果给定的数组为空或无法找到：{% empty %}

<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% empty %}
    <li>Sorry, no athletes in this list.</li>(为空显示此条)
{% endfor %}
</ul>

if

所述标签计算一个变量，并且如果该变量是“真”（即存在，不为空，并且不是假布尔值）的数据块的内容被输出

{% 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 %}

布尔运算符 and or not

and 优先级高于or

{% 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.
{% endif %}

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

其他布尔运算符

过滤器

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

ifequal和ifnotequal

{% ifequal a b %} ... {% endifequal %}是一种过时的写作方式 。同样，被取代。在和标签将在未来的版本中将会弃用。{% if a == b %} ... {% endif %}{% ifnotequal a b %} ... {% endifnotequal %}{% if a != b %} ... {% endif %}ifequalifnotequal

ifchanged

检查一个值是否从循环的最后一次迭代中发生了变化。

include

加载模板并使用当前上下文呈现它。这是一种在模板中“包含”其他模板的方法。(可用变量)
您可以使用关键字参数将其他上下文传递给模板

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

如果只想使用提供的变量（甚至根本没有变量）渲染上下文，请使用该only选项。包含的模板没有其他变量可用：

{% include "name_snippet.html" with greeting="Hi" only %}
不推荐使用

load

加载自定义模板标记集。
例如，以下模板将加载在包中注册somelibrary和otherlibrary位于包中的 所有标记和过滤器package

{% load somelibrary package.otherlibrary %}

您还可以使用from参数从库中选择性地加载单个过滤器或标记。在此示例中，模板标记/过滤器已命名foo 并将bar从somelibrary以下位置加载

{% load foo bar from somelibrary %}

lorem

显示随机的“lorem ipsum”拉丁文。这对于在模板中提供样本数据非常有用。

{% lorem [count] [method] [random] %}

now

使用根据给定字符串的格式显示当前日期和/或时间。此类字符串可以包含格式说明符字符，

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

传递的格式也可以是预定义者之一 DATE_FORMAT，DATETIME_FORMAT， SHORT_DATE_FORMAT或SHORT_DATETIME_FORMAT。预定义格式可能会根据当前区域设置和启用的格式化本地化而有所不同，

regroup

通过公共属性重新组合相似对象的列表

cities = [
    {'name': 'Mumbai', 'population': '19,000,000', 'country': 'India'},
    {'name': 'Calcutta', 'population': '15,000,000', 'country': 'India'},
    {'name': 'New York', 'population': '20,000,000', 'country': 'USA'},
    {'name': 'Chicago', 'population': '7,000,000', 'country': 'USA'},
    {'name': 'Tokyo', 'population': '33,000,000', 'country': 'Japan'},
]

您可以使用标记按国家/地区对城市列表进行分组。

{% regroup cities by country as country_list %}

<ul>
{% for country in country_list %}
    <li>{{ country.grouper }}
    <ul>
        {% for city in country.list %}
          <li>{{ city.name }}: {{ city.population }}</li>
        {% endfor %}
    </ul>
    </li>
{% endfor %}
</ul>

• 印度
  • 孟买：19,000,000
  • 加尔各答：15,000,000
• 美国
  • 纽约：20,000,000
  • 芝加哥：7,000,000
• 日本
  • 东京：33,000,000

resetcycle

重置上一个循环，以便在下次遇到时从第一个项目重新开始。

spaceless

删除HTML标记之间的空格。这包括制表符和换行符。
只删除标签之间的空格- 而不是标签和文本之间的空格。

templatetag

输出用于组成模板标记的语法字符之一
由于模板系统没有“转义”的概念，因此要显示模板标签中使用的其中一个位，必须使用该标签。{% templatetag %}

{% templatetag openblock %} url 'entry_list' {% templatetag closeblock %}

url

回与给定视图和可选参数匹配的绝对路径引用（不带域名的URL）。将使用编码生成的路径中的任何特殊字符iri_to_uri()。

{% url 'some-url-name' v1 v2 %}

第一个参数是URL模式名称。它可以是带引号的文字或任何其他上下文变量。其他参数是可选的，应该是空格分隔的值，将用作URL中的参数。
或者，您可以使用关键字语法

{% url 'some-url-name' arg1=v1 arg2=v2 %}

verbatim

停止模板引擎呈现此块标记的内容。

常见的用途是允许JavaScript模板层与Django的语法冲突。

{% verbatim %}
    {{if dying}}Still alive.{{/if}}
{% endverbatim %}

widthratio

对于创建条形图等，此标记计算给定值与最大值的比率，然后将该比率应用于常量。

<img src="bar.png" alt="Bar"
     height="10" width="{% widthratio this_value max_value max_width %}" />

在某些情况下，您可能希望捕获widthratio变量的结果。例如，它可以是blocktrans这样的：

{% widthratio this_value max_value max_width as width %}
{% blocktrans %}The width is: {{ width }}{% endblocktrans %}

with

以更简单的名称缓存复杂变量。这在多次访问“昂贵”方法（例如，访问数据库的方法）时很有用。

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

可分配多个变量

内置过滤器参考

（add）
此过滤器将首先尝试将两个值强制转换为整数。如果失败，它将尝试将值加在一起。这将适用于某些数据类型（字符串，列表等），而对其他数据类型则失败。如果失败，结果将为空字符串。
(escape)
< 转换为 <
> 转换为 >
' （单引号）转换为 '
" （双引号）转换为 "
& 转换为 &
（linebreaks）
用适当的HTML替换纯文本中的换行符; 单个换行符成为HTML换行符（），后面跟空行的换行符成为段落符号（）。<br /></p>