学习笔记,仅供参考
参考自:Django打造大型企业官网–Huang Y;官方文档
本系列Blog以应用为主,理论基础部分我在后端专栏的Django系列博客已经写过了,如果有些需要补充的知识点,我会在这个系列中,尽量详细的记录一下。
文章目录
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 %}