Django模板语言,标签整理
Django模板语言 标签
内置标签引用
1. autoescape
控制自动转义是否可用. 这种标签带有任何 on
或 off
作为参数的话,他将决定转义块内效果。 该标签会以一个endautoescape
作为结束标签.
当自动转义生效时,所有变量内容会被转义成HTML输出(在所有过滤器生效后) 这等同与手动将escape
筛选器应用于每个变量。
实例:
1)
<!-- index.html文件 -->
<body>
<p>{{ text }}</p>
{% autoescape off %}
{{ text }}
{% endautoescape %}
</body>
如果: text = "<b>文本内容</b>"
页面显示结果:
<b>文本内容</b>
文本内容
2)
<!-- index.html文件 -->
<body>
<p>{{ text }}</p>
{% autoescape off %}
{{ text|escape }}
{% endautoescape %}
</body>
页面显示结果:
<b>文本内容</b>
<b>文本内容</b>
使用了escape过滤器, 则对text文本转义
Django转义默认是开启的, 关闭转义有两种方式
(1) safe 一般作用于单行文本
(2) autoescape off 一般作用于块级内容
实例:
1)
<body>
<p>{{ text }}</p>
{% autoescape on %}
{{ text }}
{% endautoescape %}
</body>
页面显示结果:
<b>文本内容</b>
<b>文本内容</b>
2)
<body>
<p>{{ text|safe }}</p>
{% autoescape off %}
{{ text }}
{{ text|escape }}
{% endautoescape %}
</body>
页面显示结果:
文本内容
文本内容
2. block
一般在父模板可以使用block标签, 把变化的内容可以包裹在block标签内; 子模板引用父模板后, 可以使用block标签重写内容, 覆盖父模板中原来的内容.
实例:
<!-- 父模板html -->
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>年度页面</title>
</head>
<body>
<div>
<p>这是年度新闻</p>
</div>
{% block content %}
<p>页面主体内容</p>
{% endblock content %}
</body>
</html>
<!-- 子模板一 html -->
{% extends 'show_year.html' %}
<!-- 子模板二 html -->
{% extends 'show_year.html' %}
{% block content %}
<p>子模板中内容</p>
{% endblock %}
子模板的显示结果:
子模板一:
这是年度新闻
页面主题内容
子模板二:
这是年度新闻
子模板中内容
3. comment
在 {% comment %}
和 {% endcomment %}
,之间的内容会被忽略,作为注释。相当于多行注释
示例:
{% comment %}
<b>粗体</b>
<div>
<p>这是Index页面</p>
</div>
{% endcomment %}
这部分注释的内容, 在服务器端就直接忽略到了, 不会发送给客户端.
4. csrf_token
这个标签用于跨站请求伪造保护.
客户端在提交表单到服务端时, 如果表单中不写这个标签, 服务端会直接返回403 Forbidden
的错误. 把这个标签写到表单中, 可以避免发生这个错误.
当把csrf_token写到表单中后, 其实客户端在提交数据时, 会提交一个name=csrfmiddlewaretoken
, value
为随机的64位字符给服务端, 服务端收到后, 会根据这串字符校验客户端的合法性.(如果想看这个csrfmiddlewaretoken的具体内容,可以打开浏览器的调试控制台; 你会看到一个属性type='hidden'的input标签, value
已经有默认值).
表单
<form action="" method="POST">
{% csrf_token %}
<input type="text" name="name" placeholder="姓名">
<button type="submit">提交</button>
</form>
5. cycle
每当这个标签被访问,则传出一个它的可迭代参数的元素。 第一次访问返回第一个元素,第二次访问返回第二个参数,以此类推. 一旦所有的变量都被访问过了,就会回到最开始的地方,重复下去
实例:
1) 这个标签在循环中特别有用:
{% for o in some_list %}
<tr class="{% cycle 'row1' 'row2' %}">
...
</tr>
{% endfor %}
第一次迭代产生的HTML引用了
row1
类,第二次则是row2
类,第三次 又是row1
类,如此类推。2) 你也可以使用变量, 例如,如果你有两个模版变量,
rowvalue1
和rowvalue2
, 你可以让他们的值像这样替换:{% for o in some_list %}
<tr class="{% cycle rowvalue1 rowvalue2 %}">
...
</tr>
{% endfor %}
被包含在cycle中的变量将会被转义。 你可以禁止自动转义:
{% for o in some_list %}
<tr class="{% autoescape off %}{% cycle rowvalue1 rowvalue2 %}{% endautoescape %}">
...
</tr>
{% endfor %}
你能混合使用变量和字符串:
{% for o in some_list %}
<tr class="{% cycle 'row1' rowvalue2 'row3' %}">
...
</tr>
{% endfor %}
6. debug
输出整个调试信息,包括当前上下文和导入的模块。
7. extends
表示当前模板继承自一个父模板
这个标签可以有两种用法:
{% extends "base.html" %}
(要有引号).继承名为"base.html"
的父模板{% extends 变量 %}
使用variable
如果变量被计算成一个字符串,Django将会把它看成是父模版的名字。 如果变量被计算到一个Template
对象,Django将会使用那个对象作为一个父模版。
通常模板名称是相对于模板加载器的根目录。 字符串参数也可以是以./
或../
开头的相对路径。 例如,假设以下目录结构:
dir1/
template.html
base2.html
my/
base3.html
base1.html
在template.html
中,以下路径将有效:
{% extends "./base2.html" %}
{% extends "../base1.html" %}
{% extends "./my/base3.html" %}
8. filter
通过一个或多个过滤器对内容过滤。 作为灵活可变的语法,多个过滤器被管道符号相连接,且过滤器可以有参数。
注意块中所有的内容都应该包括在endfilter
和filter
标签中。
注: escape
和safe
过滤器不是可接受的参数。 而应使用autoescape
标记来管理模板代码块的自动转义。
实例:
{% filter force_escape|lower %}
This text will be HTML-escaped, and will appear in all lowercase.
{% endfilter %}
{% autoescape off %}
{% filter force_escape|lower %}
This text will be HTML-escaped, and will appear in all lowercase.
{% endfilter %}
{% endautoescape %}
9. firstof
输出第一个不为False
参数。 如果传入的所有变量都为False
,就什么也不输出。
例如:
{% firstof var1 var2 var3 %}
它等价于:
{% if var1 %}
{{ var1 }}
{% elif var2 %}
{{ var2 }}
{% elif var3 %}
{{ var3 }}
{% endif %}
当然你也可以用一个默认字符串作为输出以防传入的所有变量都是False:
{% firstof var1 var2 var3 "default value" %}
10. for
循环组中的每一个项目,并让这些项目在上下文可用。 举个例子,展示athlete_list
中的每个成员:
<ul>
{% for athlete in athlete_list %}
<li>{{ athlete.name }}</li>
{% endfor %}
</ul>
可以利用{% for obj in list reversed %}
反向完成循环。
如果你需要循环一个包含列表的列表,可以通过拆分每一个二级列表为一个独立变量来达到目的。 举个例子,如果你的内容包括一个叫做points
的(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 %}
请记住,对于点运算符,字典键查找优先于方法查找。如果要在模板中使用这些方法(items
,values
,keys
等),请避免添加名为字典方法的键。
for循环可用的参数:
变量 | 描述 |
---|---|
forloop.counter |
当前循环的索引值(索引从1开始) |
forloop.counter0 |
当前循环的索引值(索引从0开始) |
forloop.revcounter |
当前循环的倒序索引值(索引从1开始) |
forloop.revcounter0 |
当前循环的倒序索引值(索引从0开始) |
forloop.first |
如果这是第一次循环,返回True |
forloop.last |
如果这是最后一次循环,则为True |
forloop.parentloop |
对于嵌套循环,这是当前循环的外层循环 |
11. 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>
它和下面的例子作用相等,但是更简洁、更清晰甚至可能运行起来更快:
<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>
12. if
{% if %}
会对一个变量求值,如果它的值是“True”(存在、不为空、且不是boolean类型的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 }}
过滤器展示出athletes的数量。
正如你所见,if
标签之后可以带有一个或者多个{% elif %}
从句,也可以带有一个{% else %}
从句以便在之前的所有条件不成立的情况下完成执行。 这些从句都是可选的。
if
标签可以使用not
,and
或or
来测试多个变量的布尔值.
13. include
加载模板并以标签内的参数渲染。 这是一种可以引入别的模板的方法。
模板名可以是变量或者是硬编码的字符串,可以用单引号也可以是双引号.
下面这个示例包括模板"foo/bar.html"
的内容:
{% include "foo/bar.html" %}
通常模板名称是相对于模板加载器的根目录。 字符串参数也可以是以./
或../
开头的相对路径,如extends
标签中所述。
14. load
加载自定义模板标签集。
举个例子, 下面这模板将会从package
包中载入所有otherlibrary
和somelibrary
中已经注册的标签和过滤器:
{% load somelibrary package.otherlibrary %}
你还可以使用from
参数从库中选择性加载单个过滤器或标记。 在下面这个示例中,名为somelibrary
和bar
的模板标签/过滤器将从foo
加载:
{% load foo bar from somelibrary %}
15. now
显示最近的日期或事件,可以通过给定的字符串格式显示。
实例:
{% now 'Y-m-d H:i:s' %}
输出类似:
2018-10-11 07:05:40
您也可以使用语法{% now “Y” as current_year %}
将输出(作为字符串)存储在变量中。 This is useful if you want to use {% now %}
inside a template tag like blocktrans
for example:
{% now "Y" as current_year %}
{% blocktrans %}Copyright {{ current_year }}{% endblocktrans %}
<!-- 使用blocktrans标签需要在html文件头部加上 {% load i18n %}, 导入已有的i18n模板-->
16. regroup
用相似对象间共有的属性重组列表.
This complex tag is best illustrated by way of an example: say that cities
is a list of cities represented by dictionaries containing "name"
,"population"
, and "country"
keys:
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'},
]
...并且您想显示按国家/地区排序的分层列表,如下所示:
-
印度
- 孟买:19,000,000
- 加尔各答:15,000,000
-
美国
- 纽约:20,000,000
- 芝加哥:7,000,000
-
日本
- 东京:33,000,000
你可以使用{% regroup %}
标签来给每个国家的城市分组。 以下模板代码片段将实现这一点:
{% 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>
让我们来看看这个例子。 {% regroup %}
有三个参数: 你想要重组的列表, 被分组的属性, 还有结果列表的名字. 在这里,我们通过country_list
属性重新分组country
列表,并调用结果cities
。
{% regroup %}
产生一个清单(在本例中为country_list
的组对象。 组对象是具有两个字段的namedtuple()
的实例:
grouper
- 按分组的项目(例如,字符串“India”或“Japan”)。list
- 此群组中所有项目的列表(例如,所有城市的列表,其中country ='India')。
在Django更改1.11:
组对象已从字典更改为namedtuple()
。
Because {% regroup %}
produces namedtuple()
objects, you can also write the previous example as:
{% regroup cities by country as country_list %}
<ul>
{% for country, local_cities in country_list %}
<li>{{ country }}
<ul>
{% for city in local_cities %}
<li>{{ city.name }}: {{ city.population }}</li>
{% endfor %}
</ul>
</li>
{% endfor %}
</ul>
请注意,{% regroup %}
不会对其输入进行排序! 我们的例子依赖于事实:cities
列表首先由country
排序。 如果country
列表不通过cities
对其成员进行排序,则重新分组将天真显示单个国家/地区的多个组。 例如,假设cities
列表已设置为此(请注意,国家/地区未分组在一起):
cities = [
{'name': 'Mumbai', 'population': '19,000,000', 'country': 'India'},
{'name': 'New York', 'population': '20,000,000', 'country': 'USA'},
{'name': 'Calcutta', 'population': '15,000,000', 'country': 'India'},
{'name': 'Chicago', 'population': '7,000,000', 'country': 'USA'},
{'name': 'Tokyo', 'population': '33,000,000', 'country': 'Japan'},
]
对于cities
的输入,示例{% regroup %}
以上将导致以下输出:
-
印度
- 孟买:19,000,000
-
美国
- 纽约:20,000,000
-
印度
- 加尔各答:15,000,000
-
美国
- 芝加哥:7,000,000
-
日本
- 东京:33,000,000
另一个解决方案是使用dictsort
过滤器对模板中的数据进行排序,如果您的数据在字典列表中:
{% regroup cities|dictsort:"country" by country as country_list %}
17. resetcycle
重置先前的循环,以便在下一次遇到时从其第一个项目重新启动。 没有参数, {% resetcycle %}
会重置模板中定义的最后一个{% cycle %}
用法示例:
{% for coach in coach_list %}
<h1>{{ coach.name }}</h1>
{% for athlete in coach.athlete_set.all %}
<p class="{% cycle 'odd' 'even' %}">{{ athlete.name }}</p>
{% endfor %}
{% resetcycle %}
{% endfor %}
这个示例将返回下面的HTML:
<h1>José Mourinho</h1>
<p class="odd">Thibaut Courtois</p>
<p class="even">John Terry</p>
<p class="odd">Eden Hazard</p>
<h1>Carlo Ancelotti</h1>
<p class="odd">Manuel Neuer</p>
<p class="even">Thomas Müller</p>
注意第一个块以class="odd"
结束,新的以class="odd"
开头。 没有{% resetcycle %}
标签,第二个块将以class="even"
18. spaceless
删除HTML标签之间的空白格. 包括制表符和换行.
用法示例:
{% spaceless %}
<p>
<a href="foo/">Foo</a>
</p>
{% endspaceless %}
这个示例将返回下面的HTML:
<p><a href="foo/">Foo</a></p>
注: 仅删除 tags 之间的空格 – 而不是标签和文本之间的。
19. url
返回与给定视图和可选参数匹配的绝对路径引用(不带域名的URL)。 在解析后返回的结果路径字符串中,每个特殊字符将使用iri_to_uri()
编码。
这是一种不违反DRY原则的输出链接的方式,它可以避免在模板中硬编码链接路径。
{% url 'some-url-name' v1 v2 %}
第一个参数是url()
name
。 它可以是一个被引号引起来的字符串或者其他的上下文变量. 其他参数是可选的并且应该以空格隔开,这些值会在URL中以参数的形式传递. 上面的例子展示了如何传递位置参数. 当然你也可以使用关键字参数.
{% url 'some-url-name' arg1=v1 arg2=v2 %}
不要把位置参数和关键字参数混在一起使用。 URLconf所需的所有参数都应该存在。
例如,假设您有一个视图app_views.py
,其URLconf接受客户端ID(此处client()
是视图文件app_views.client
)。 URLconf行可能如下所示:
('^client/([0-9]+)/$', app_views.client, name='app-views-client')
如果你的应用中的URLconf 已经被包含到项目 URLconf 中,比如下面这样
('^clients/', include('project_name.app_name.urls'))
然后,在模板中,您可以创建一个此视图的链接,如下所示:
{% url 'app-views-client' client.id %}
模板标签会输出如下的字符串 /clients/client/123/
.
如果您要检索名称空间网址,请指定完全限定名称:
{% url 'myapp:view-name' %}
20. widthratio
为了创建条形图等,此标签计算给定值与最大值的比率,然后将该比率应用于常量。
像这样:
<img src="bar.png" alt="Bar"
height="10" width="{% widthratio this_value max_value max_width %}" />
如果max_width
是175,max_value
是200,并且this_value
是100,则上述示例中的图像将是88像素宽(因为175 / 200 = .875; .875 * 100 = 87.5,上舍入为88)。
在某些情况下,您可能想要捕获变量中的widthratio
的结果。 它可以是有用的,例如,在blocktrans
像这样:
{% widthratio this_value max_value max_width as width %}
{% blocktrans %}The width is: {{ width }}{% endblocktrans %}
21. with
使用一个简单地名字缓存一个复杂的变量 ,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的
像这样:
{% with total=business.employees.count %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
填充变量(以上示例total
)仅适用于{% 与 %} t5>
和{% endwith %}
标签。
你可以分配多个上下文变量:
{% with alpha=1 beta=2 %}
...
{% endwith %}
参考文档: https://yiyibooks.cn/xx/Django_1.11.6/ref/templates/builtins.html#ref-templates-builtins-tags
Django内置模板标签
-
autoescape
- 控制自动转义是否可用,这种标签带有任何on和off作为参数的话,他将决定转义块内效果。
- 该标签会以一个endautoescape作为结束标签。
- 当自动转义生效时,所有变量内容会被转义成HTML输出(在所有过滤器生效后)这等同与
- 唯一一个例外是,变量或者通过渲染变量的代码,或者因为他已经应用了safe或escape过
-
block
- block 标签可以被子模板覆盖
-
comment
- 在{% comment %} 和 {% endcomment %},之间的内容会被忽略,作为注释。在第一个
标签可以插入一个可选的记录。比如,当要注释掉一些代码时,可以用此来记录代码被注
释掉的原因。
- 在{% comment %} 和 {% endcomment %},之间的内容会被忽略,作为注释。在第一个
-
Csrf_token
- 这个标签用于跨站请求伪造保护
-
cycle
- 每当这个标签被访问,则传出一个它的可迭代参数的元素。第一次访问返回第一个元素,第二
次访问返回第二个参数,依次类推,一旦所有的变量都被访问过了,就会回到最开始的地方,
重复下去。
这个标签在循环中特别好用
- 每当这个标签被访问,则传出一个它的可迭代参数的元素。第一次访问返回第一个元素,第二
- 也可以使用变量,例如,如果有两个模板变量,rowvalue1和rowvalue2,可以让他们的值像这
样一样替换
- 被包含在cycle中的变量将会被转义,可以禁止自动转义
- 能够混合使用变量和字符串
- 在某些情况下,可能需要连续引用一个当前循环的值,而不前进到下一个循环值。要达到这个
目的,只需要使用“as”来给{% cycle %}一个别名,
- 设置别名后,可以通过将别名作为一个模板变量进行引用,从而随意在模板中插入当前循环的
值。如果要将循环值移到独立于原始cycle标记的下一个值,可以使用另一个cycle标记并指定
变量的名称。
- 默认情况下,当你在cycle标签中使用as 关键字时,关于{% cycle %}的使用,会启动cycle并且直接产生第一个值。 如果你想要在嵌套循环中或者included模版中使用这个值,那么将会遇到困难。 如果你只是想要声明cycle,但是不产生第一个值,你可以添加一个silent关键字来作为cycle标签的最后一个关键字。 像这样:
- The following template would output nothing, even though the second call to{% cycle %} doesn’t specify silent:
-
debug
- 输出整个调试信息,包括当前上下文和导入的模块。
-
extends
- 表示当前模板继承自一个父模板
这个标签可以有以下两种用法 - {% extends “base.html” %} (要有引号).继承名为”base.html”的父模板
- {% extends variable %}使用variable 如果变量被计算成一个字符串,Django将会把它看成是父模版的名字。 如果变量被计算到一个Template对象,Django将会使用那个对象作为一个父模版。
- 表示当前模板继承自一个父模板
-
filter
- 通过一个或多个过滤器对内容过滤。 作为灵活可变的语法,多个过滤器被管道符号相连接,且过滤器可以有参数。
-
firstof
- 输出第一个不为False参数。如果传入的所有变量都为False,就什么也不输出。
- 当然你也可以用一个默认字符串作为输出以防传入的所有变量都是False:
- 标签auto-escapes是开启的, 你可以禁止自动转义:
- 如果只想要部分变量被规避,可以这样使用:
- for
for
- 循环组中的每一个项目,并让这些项目在上下文可用。 举个例子,展示athlete_list中的每个成员:
- 可以利用{% for obj in list reversed %}反向完成循环。
如果你需要循环一个包含列表的列表,可以通过拆分每一个二级列表为一个独立变量来达到目的。 举个例子,如果你的内容包括一个叫做points的(x,y) 列表,你可以像以下例子一样输出points列表:
- 如果你想访问一个字典中的项目,这个方法同样有用。 举个例子:如果你的内容包含一个叫做data的字典,下面的方式可以输出这个字典的键和值:
- 请记住,对于点运算符,字典键查找优先于方法查找。
- Therefore if the data dictionary contains a key named ‘items’, data.items will return data[‘items’] instead ofdata.items().
- 如果要在模板中使用这些方法(items,values,keys等),请避免添加名为字典方法的键。
-
The current iteration of the loop (1-indexed)
变量 描述
forloop.counter 循环的当前迭代(1索引)
forloop.counter0 循环的当前迭代(0索引)
forloop.revcounter 循环结束的迭代次数(1索引)
forloop.revcounter0 循环结束的迭代次数(0索引)
forloop.first 如果这是第一次通过循环,则为真
forloop.last 如果这是最后一次循环,则为真
forloop.parentloop 对于嵌套循环,这是围绕当前循环的循环
for … empty
for 标签带有一个可选的{% empty %} 从句,以便在给出的组是空的或者没有被找到时,可以有所操作。
它和下面的例子作用相等,但是更简洁、更清晰甚至可能运行起来更快:
-
if
- {% if %}会对一个变量求值,如果它的值是“True”(存在、不为空、且不是boolean类型的false值),这个内容块会输出:
- 上述例子中,如果athlete_list不为空,就会通过使用{{ athlete_list|length }}过滤器展示出athletes的数量。
- if标签之后可以带有一个或者多个{% elif %} 从句,也可以带有一个{% else %}从句以便在之前的所有条件不成立的情况下完成执行。 这些从句都是可选的。
布尔运算符
if标签可以使用not,and或or来测试多个变量或取消给定变量:
允许同时使用and和or子句,and的优先级高于or :
解释如下:
在if标记中使用实际括号是无效的语法。 如果您需要它们指示优先级,则应使用嵌套的if标记。
- if tags may also use the operators ==, !=, <, >, <=, >=, in, not in, is, and is not which work as follows:
== operator
相等。 例如:
!= operator
不相等。 例如:
<operator
小于。 例如:
operator
大于。 例如:
<= operator
小于或等于。 例如:
= operator
大于或等于。 例如:
in操作符
包含在内。 许多Python容器支持此运算符,以测试给定值是否在容器中。 以下是 中的x 的一些示例将被解释:
not in操作符
不包含在内。 这是in运算符的否定操作。
is operator
Django中的新功能1.10。
对象身份。 测试两个值是否相同。 例如:
is not操作符
Django中的新功能1.10。
否定对象身份 测试两个值是否不一样。 这是is运算符的否定。 例如:
过滤器
你也可以在 if表达式中使用过滤器。 像这样:
复合表达式
所有上述操作符可以组合以形成复杂表达式。 对于这样的表达式,重要的是要知道在表达式求值时如何对运算符进行分组 - 即优先级规则。 操作符的优先级从低至高如下:
- or
- and
- not
- in
- ==,!=,<,>,<= ,>=
(这完全依据Python)。 所以,例如,下面的复杂if标签:
…将被解释为:
如果你想要不同的优先级,那么你需要使用嵌套的if 标签。 有时,为了清楚起见,更好的是为了那些不知道优先规则的人。
比较运算符不能像Python或数学符号中那样“链接”。 例如,不能使用:
你应该使用:
-
ifchanged
- 检查一个值是否在上一次的迭代中改变。
{% ifchanged %} 块标签用在循环里。 它可能有两个用处:
检查它已经渲染过的内容中的先前状态。并且只会显示发生改变的内容。 例如, 以下的代码是
输出days的列表项,不过它只会输出被修改过月份的项:
- 检查一个值是否在上一次的迭代中改变。
- 如果标签内被给予多个值时,则会比较每一个值是否与上一次不同。 例如,以下显示每次更改时
- ifchanged标记也可以采用可选的{% else %} 将显示如果值没有改变:
-
include
- 加载模板并以标签内的参数渲染。 这是一种可以引入别的模板的方法。
模板名可以是变量或者是硬编码的字符串,可以用单引号也可以是双引号.
下面这个示例包括模板”foo/bar.html”的内容:
- 加载模板并以标签内的参数渲染。 这是一种可以引入别的模板的方法。
- 通常模板名称是相对于模板加载器的根目录。 字符串参数也可以是以./或../开头的相对路径,如extends标签中所述。
Django中的新功能1.10:添加了使用相对路径的能力。
此示例包括其名称包含在变量template_name中的模板的内容:
- 变量也可以是任何实现了render() 方法接口的对象,这个对象要可以接收上下文(context)。 这就允许你在context中引用一个已经被编译过的Template。
被包含的模板在包含它的模板的上下文中渲染。
下面这个示例生成输出“Hello, John!”:
上下文:变量greeting设置为”John”,变量person设置为”Hello”。
模板:
- 你可以使用关键字参数将额外的上下文传递到模板:
- 如果要仅使用提供的变量(或根本不使用变量)来渲染上下文,请使用only选项。 所包含的模板没有其他变量可用:
- 如果包含的模板在渲染时导致异常(包括缺少或具有语法错误),行为会因template engine’s而异。 debug选项(如果未设置,此选项默认为DEBUG的值)。 当调试模式打开时,将出现TemplateDoesNotExist或TemplateSyntaxError之类的异常。当调试模式关闭时,{% 包括 %}向django.template记录器,除了在渲染所包含的模板并返回一个空字符串时发生的异常。
- 自1.11版以来已弃用 渲染{% 包含 %}模板标记的沉默异常已弃用。 在Django 2.1中,将会提出异常。
-
注
include 标签应该被理解为是一种”将子模版渲染并嵌入HTML中”的变种方法,而不是认为是”解析子模版并在被父模版包含的情况下展现其被父模版定义的内容”.这意味着在不同的被包含的子模版之间并不共享父模版的状态,每一个子包含都是完全独立的渲染过程.
Block模块在被包含 之前 就已经被执行. 这意味着模版在被包含之前就已经从另一个block扩展并 已经被执行并完成渲染 - 没有block模块会被include引入并执行,即使父模版中的扩展模版.- load
-
加载自定义模板标签集。
举个例子, 下面这模板将会从package包中载入所有otherlibrary 和somelibrary 中已经注册的标签和过滤器:
- 还可以使用from参数从库中选择性加载单个过滤器或标记。 在下面这个示例中,名为somelibrary和bar的模板标签/过滤器将从foo加载:
-
now
- 显示最近的日期或事件,可以通过给定的字符串格式显示。 此类字符串可以包含格式说明符字符,如date过滤器部分中所述。
例如:
- 显示最近的日期或事件,可以通过给定的字符串格式显示。 此类字符串可以包含格式说明符字符,如date过滤器部分中所述。
- 注意!,如果你想要使用“raw”值,你能够反斜杠转义一个格式化字符串。 在这个例子 中,“o”和“f”都是反斜杠转义,因为如果不这样,会分别显示年和时间:
It is the {% now "jS \o\f F" %}
这将显示为“这是9月4日”。
- 注
传递的格式也可以是预定义的DATE_FORMAT,DATETIME_FORMAT,SHORT_DATE_FORMAT或SHORT_DATETIME_FORMAT之一。 预定义的格式可能会因当前语言环境和Format localization的启用而有所不同,
例如:
- 也可以使用语法{% now “Y” as current_year %}将输出(作为字符串)存储在变量中。 This is useful if you want to use {% now %} inside a template tag likeblocktrans for example:
-
regroup
- 用相似对象间共有的属性重组列表.
- This complex tag is best illustrated by way of an example: say that cities is a list of cities represented by dictionaries containing “name”, “population”, and “country” keys:
并且想显示按国家/地区排序的分层列表,如下所示:
- 印度
- 孟买:19,000,000
- 加尔各答:15,000,000
- 美国
- 纽约:20,000,000
- 芝加哥:7,000,000
- 日本
- 东京:33,000,000
你可以使用{% regroup %}标签来给每个国家的城市分组。 以下模板代码片段将实现这一点:
{% regroup %}产生一个清单(在本例中为country_list的组对象。 组对象是具有两个字段的namedtuple()的实例:
- grouper - 按分组的项目(例如,字符串“India”或“Japan”)。
- list - 此群组中所有项目的列表(例如,所有城市的列表,其中country =’India’)。
在Django更改1.11:组对象已从字典更改为namedtuple()。
Because {% regroup %} produces namedtuple() objects, you can also write the previous example as:
请注意,{% regroup %}不会对其输入进行排序! 我们的例子依赖于事实:cities列表首先由country排序。 如果country列表不通过cities对其成员进行排序,则重新分组将天真显示单个国家/地区的多个组。 例如,假设cities列表已设置为此(请注意,国家/地区未分组在一起):
对于cities的输入,示例{% regroup %}以上将导致以下输出:
- 印度
- 孟买:19,000,000
- 美国
- 纽约:20,000,000
- 印度
- 加尔各答:15,000,000
- 美国
- 芝加哥:7,000,000
- 日本
- 东京:33,000,000
这个问题的最简单的解决方案是确保在你的视图代码中,数据是根据你想要显示的顺序排序。
另一个解决方案是使用dictsort过滤器对模板中的数据进行排序,如果您的数据在字典列表中:
分组其他属性
- 一个有效的模版查找是一个regroup标签的合法的分组属性。包括方法,属性,字典健和列表项。 例如,如果“country”字段是具有属性“description”的类的外键,则可以使用:
- 或者,如果choices是具有choices的字段,则它将具有作为属性的get_FOO_display()方法,显示字符串而不是country键:
- resetcycle
- 重置先前的循环,以便在下一次遇到时从其第一个项目重新启动。 没有参数,{% resetcycle %} 会重置模板中定义的最后一个{% cycle %}
用法示例:
这个示例将返回下面的HTML:
注意第一个块以class=”odd”结束,新的以class=”odd”开头。 没有{% resetcycle %}标签,第二个块将以class=”even”
- 还可以重置命名循环标签:
在这个例子中,我们有交替的奇数/偶数行和第五行的“主要”行。 当类别更改时,只有五行周期被重置。
-
spaceless
- 删除HTML标签之间的空白格. 包括制表符和换行.
用法示例:
- 删除HTML标签之间的空白格. 包括制表符和换行.
- 仅删除 tags 之间的空格 – 而不是标签和文本之间的。 在此示例中,Hello周围的空格不会被删除:
-
templatetag
- 输出用于构成模板标记的语法字符之一。
- 由于模板系统没有“转义”的概念,为了显示模板标签中使用的一个位,必须使用{% templatetag %}标记。
- 参数指定要输出哪个模板位:
论据 输出
openblock {%
closeblock %}
openvariable {{
closevariable }}
openbrace {
closebrace }
opencomment {#
closecomment #}
例如:
-
url
- 返回与给定视图和可选参数匹配的绝对路径引用(不带域名的URL)。 在解析后返回的结果路径字符串中,每个特殊字符将使用iri_to_uri()编码。
- 这是一种不违反DRY原则的输出链接的方式,它可以避免在模板中硬编码链接路径。
- 第一个参数是url() name。 它可以是一个被引号引起来的字符串或者其他的上下文变量. 其他参数是可选的并且应该以空格隔开,这些值会在URL中以参数的形式传递. 上面的例子展示了如何传递位置参数. 当然你也可以使用关键字参数.
- 不要把位置参数和关键字参数混在一起使用。 URLconf所需的所有参数都应该存在。
例如,假设您有一个视图app_views.py,其URLconf接受客户端ID(此处client()是视图文件app_views.client)。 URLconf行可能如下所示:
- as var语法创建的变量的范围是{% 块 %}其中{% url %} 标签出现。
此标签 {% url … as VAR %} 语法将不导致错误,如果视图丢失。 实际上,您将使用此链接来链接到可选的视图:
- 如果要检索名称空间网址,请指定完全限定名称:
- 警告
不要忘记在url() name之间放置引号,否则该值将被解释为上下文变量!
-
verbatim
- 停止模版引擎在该标签中的渲染/
- 常见的用法是允许与Django语法冲突的JavaScript模板图层。 像这样:
- You can also designate a specific closing tag, allowing the use of {% endverbatim %} as part of the unrendered contents:
-
widthratio
- 为了创建条形图等,此标签计算给定值与最大值的比率,然后将该比率应用于常量。
像这样:
- 为了创建条形图等,此标签计算给定值与最大值的比率,然后将该比率应用于常量。
- 如果max_width是175,max_value是200,并且this_value是100,则上述示例中的图像将是88像素宽(因为175 / 200 = .875; .875 * 100 = 87.5,上舍入为88)。
- 在某些情况下,您可能想要捕获变量中的widthratio的结果。 它可以是有用的,例如,在blocktrans像这样:
-
with
- 使用一个简单地名字缓存一个复杂的变量 ,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的
像这样:
- 使用一个简单地名字缓存一个复杂的变量 ,当你需要使用一个“昂贵的”方法(比如访问数据库)很多次的时候是非常有用的
- 填充变量(以上示例total)仅适用于{% with %} t5>和{% endwith %}标签。
可以分配多个上下文变量: