Django从理论到实战(part19)--DTL模板语法

学习笔记，仅供参考

参考自：Django打造大型企业官网–Huang Y；官方文档

本系列Blog以应用为主，理论基础部分我在后端专栏的Django系列博客已经写过了，如果有些需要补充的知识点，我会在这个系列中，尽量详细的记录一下。

文章目录

DTL模板语法
- 变量
- 常用标签
- - `if`标签
  - `for...in...`标签
  - `for...in...empty`标签
  - `with`标签
  - `url`标签
  - `spaceless`标签
  - `autoescape`标签
  - `verbatim`标签

DTL模板语法

变量

模板中可以包含变量，Django在渲染模板的时候，可以传递变量对应的值过去进行替换。变量的命名规范和Python非常类似，只能是阿拉伯数字和英文字符以及下划线的组合，不能出现标点符号等特殊字符，例如：

{# profile.html模板代码 #}
<p>{{ username }}</p>

模板中的变量同样也支持点.的形式，比如person.username，模板是按照以下方式进行解析的：

如果person是一个字典，那么就会查找这个字典的username这个key对应的值。
如果person是一个对象，那么就会查找这个对象的username属性，或者是username这个方法。
如果出现的是person.0，则Django会判断persons是否是一个列表或者元组或者任意的可以通过下标访问的对象，如果是的话就取这个列表的第1个值，如果不是，获取到的就是一个空的字符串。

常用标签

`if`标签

if标签相当于Python中的if语句，有elif和else相对应，但是所有的标签都需要用标签符号（{%%}）进行包裹。if标签中可以使用==、!=、<、<=、>、>=、in、not in、is、is not等判断运算符，例如：

 {% if "张三" in persons %}<p>张三</p>{% else %}<p>李四</p>{% endif %}

`for...in...`标签

for...in...标签类似于Python中的for...in...。可以遍历列表、元组、字符串、字典等一切可以遍历的对象，例如：

 {% for person in persons %}<p>{{ person.name }}</p>{% endfor %}

如果想要反向遍历，那么在遍历的时候就加上一个reversed，例如：

 {% for person in persons reversed %}<p>{{ person.name }}</p>{% endfor %}

在python中，需要使用items、keys和values等方法遍历字典，在DTL中，执行上述方法的语法如下：

 {% for key,value in person.items %}<p>key：{{ key }}</p><p>value：{{ value }}</p>{% endfor %}

在for循环中，DTL提供了一些变量供我们使用，详见下表：

变量	解释
`forloop.counter`	当前循环的下标，以1作为起始值
`forloop.counter0`	当前循环的下标，以0作为起始值
forloop.revcounter0	类似于forloop.revcounter，不同的是最后一个元素的下标是从0开始
`forloop.revcounter`	当前循环的反向下标值，比如列表有5个元素，那么第一次遍历这个属性是等于5，第二次是4，以此类推。并且是以1作为最后一个元素的下标
`forloop.first`	是否是第一次遍历
`forloop.last`	是否是最后一次遍历
`forloop.parentloop`	如果有多个循环嵌套，那么这个属性代表的是上一级的for循环

`for...in...empty`标签

该标签使用跟for...in...是一样的，只不过是在遍历的对象如果没有元素的情况下，会执行empty中的内容，例如：

 {% for person in persons %}<li>{{ person }}</li>{% empty %}无元素{% endfor %}

`with`标签

该标签可以帮助我们在模版中定义变量。有时候一个变量的访问比较复杂，那么可以先把这个变量缓存到另一个变量上，之后就可以直接使用这个变量了，例如：

#视图模块中
context = {"persons": ["小黄","大白"]}#模板文件中{% with lisi=persons.1 %}<p>{{ lisi }}</p>{% endwith %}

还有另外一种写法：

{% with persons.1 as lisi %}<p>{{ lisi }}</p>
{% endwith %}

需要注意的是：

在with语句中定义的变量，只能在{%with%}{%endwith%}中使用，不能在这个标签外面使用；
定义变量的时候，不能在等号左右两边留有空格，比如，{% with lisi = persons.1%}是错误的。

`url`标签

在模版中，我们经常要写一些url，比如在a标签中定义href属性，如果我们通过硬编码的方式直接将这个url写死也是可以的，但是这样对于以后项目维护可能不是一件好事，因此建议使用反转的方式来实现，类似于django中的reverse一样，例如：

<a href="{% url 'book:list' %}">图书列表页面</a>

如果url反转的时候需要传递参数，那么可以通过位置参数和关键字参数两种方式，注意位置参数和关键字参数不能同时使用，例如：

#urls.py模块中path('detail/<book_id>/',views.book_detail,name='detail')#模板文件中
#url反转，使用位置参数
<a href="{% url 'book:detail' 1 %}">图书详情页面</a>#url反转，使用关键字参数
<a href="{% url 'book:detail' book_id=1 %}">图书详情页面</a>

如果需要传递多个参数，那么通过空格的方式进行分隔，例如：

<a href="{% url 'book:detail' book_id=1 page=2 %}">图书详情页面</a>

如果想要在url标签反转时传递查询字符串的参数，那么必须要手动在在后面添加，例如：

<a href="{% url 'book:detail' book_id=1 %}?page=1">图书详情页面</a>

`spaceless`标签

该标签用于移除html标签中的空白字符，包括空格、tab键、换行等，例如：

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

渲染完成后，页面中的代码会变成下面这样：

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

spaceless只会移除html标签之间的空白字符，而不会移除标签与文本之间的空白字符，例子：

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

上述代码将不会移除strong标签中的空白字符。

`autoescape`标签

该标签可以开启和关闭这个标签内元素的自动转义功能，自动转义可以将一些特殊的字符，比如<转义成html语法能识别的字符，比如<会被转义成<，而>会被自动转义成>，模板中默认是已经开启了自动转义的，例如：

#传递的上下文信息context = {"info":"<a href='www.baidu.com'>百度</a>"}#模板中关闭自动转义{% autoescape on %}{{ info }}{% endautoescape %}

上述代码中，会显示百度的一个超链接，但是如果开启自动转义(off)，那么就会显示成一个普通的字符串。

`verbatim`标签

在DTL模板中，默认会解析一些特殊字符，比如，{%和%}以及{{等。如果我们在某个代码片段中不想使用DTL的解析引擎，那么可以把这个代码片段放在verbatim标签中，例如：

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