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​​提供了一些变量供我们使用，详见下表：

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