1.DTL模板变量使用语法
模板中可以包含变量,Django在渲染模板的时候,可以传递变量对应的值过去进行替换。变量的命名规范和Python非常类似,只能是阿拉伯数字和英文字符以及下划线的组合,不能出现标点符号等特殊字符。变量需要通过视图函数渲染,视图函数在使用render或者render_to_string的时候可以传递一个context的参数,这个参数是一个字典类型。模板中接收变量的时候 使用 {{ 变量名 }} 这样去接收。
示例代码:
# views.py代码
def profile(request):
return render(request,'profile.html',context={'username':'juran'})
class Person(object):
def __init__(self,username):
self.username = username
def index(request):
p = Person("居然")
content = {
'person':p
}
content = {
'persons':[
'a',
'b',
'c'
]
}
return render(request,"index.html",context=content)
# profile.html模板代码
{{ username }}
{{person.username}}
{{ persons.0 }}
模板中的变量同样也支持点(.)的形式。在出现了点的情况,比如person.username,模板是按照以下方式进行解析的:
注意事项:
- 不能通过中括号的形式访问字典和列表中的值,比如dict['key']和list[1]是不支持的!
- 因为使用点(.)语法获取对象值的时候,可以获取这个对象的属性,如果这个对象是一个字典,也可以获取这个字典的值。所以在给这个字典添加key的时候,千万不能和字典中的一些属性重复。比如items,items是字典的方法,那么如果给这个字典添加一个items作为key,那么以后就不能再通过item来访问这个字典的键值对了。
2. 常用的模板标签
2.1 if标签
if标签相当于Python中的if语句,有elif和else相对应,但是所有的标签都需要用标签符号({%%})进行包裹。if标签中可以使用==、!=、<、<=、>、>=、in、not in、is、is not等判断运算符。
{% if age > 18 %}
您是成年人了
{% elif age == 18 %}
您刚满18岁
{% else %}
您是未成年人
{% endif %}
{% if "张三" in persons %}
张三
{% else %}
李四
{% endif %}
用in的时候会判断类型是否相同,如果类型不相同也会判定不在列表里面
标签需要 成对出现,以 endXXX 结束
2.2 for...in...标签
for...in...类似于Python中的for...in...。可以遍历列表、元组、字符串、字典等一切可以遍历的对象。
示例代码如下:
{% for book in books %}
{{ book }}
{% endfor %}
# 反向遍历
{% for book in books reversed %}
{{ book }}
{% endfor %}
遍历字典的时候,需要使用items、keys和values等方法。在DTL中,执行一个方法不能使用圆括号的形式。示例代码如下:
{% for key,value in person.items %}
key:{{ key }}
value:{{ value }}
{% endfor %}
在for循环中,DTL提供了一些变量可供使用。
forloop.counter:当前循环的下标。以1作为起始值。
forloop.counter0:当前循环的下标。以0作为起始值。
forloop.revcounter:当前循环的反向下标值。比如列表有5个元素,那么第一次遍历这个属性是等于5,第二次是4,以此类推。并且是以1作为最后一个元素的下标。
forloop.revcounter0:类似于forloop.revcounter。不同的是最后一个元素的下标是从0开始。
forloop.first:是否是第一次遍历。
forloop.last:是否是最后一次遍历。
forloop.parentloop:如果有多个循环嵌套,那么这个属性代表的是上一级的for循环。
2.3 for...in...empty标签
这个标签使用跟for...in...是一样的,只不过是在遍历的对象如果没有元素的情况下,会执行empty中的内容。
{% for person in persons %}
{{ person }}
{% empty %}
暂时还没有任何人
{% endfor %}
注意事项:
在for循环中,break,continue语句是用不了的。
2.4 with 标签
在模版中定义变量。有时候一个变量访问的时候比较复杂,那么可以先把这个复 杂的变量缓存到一个变量上,以后就可以直接使用这个变量就可以了。示例代码如下:
context = { "persons": ["张三","李四"] }
{% with lisi=persons.1 %}
{{ lisi }}
{% endwith %}
有几点需要强烈的注意:
- 在 with 语句中定义的变量,只能在 {%with%}{%endwith%} 中使用,不能在这个标签外面 使用。
- 定义变量的时候,不能在等号左右两边留有空格。比如 {% with lisi = persons.1%} 是 错误的。
- 还有另外一种写法同样也是支持的:
{% with persons.1 as lisi %}
{{ lisi }}
{% endwith %}
2.4 url标签
- 在模版中,我们经常要写一些url,比如某个a标签中需要定义href属性。当然如果通过硬编码的方式直接将这个url写死在里面也是可以的。但是这样对于以后项目维护可能不是一件好事。因此建议使用这种反转的方式来实现,类似于django中的reverse一样。
图书列表页面
想要实现上面的效果我们需要的urls.py 中做如下调整才能使用。
app_name = "book"
urlpatterns = [
path("book_list/",views.book_list,name="book_list")
]
如不设置相应的app_name 和相应的name则 url标签映射的地址无法成功
- 如果url反转的时候需要传递参数,那么可以在后面传递。但是参数分位置参数和关键字参数。位置参数和关键字参数不能同时使用。
# path部分
path('detail//',views.book_detail,name='detail')
# url反转,使用位置参数
图书详情页面
# url反转,使用关键字参数
图书详情页面
- 如果想要在使用url标签反转的时候要传递查询字符串的参数,那么必须要手动在在后面添加。
图书详情页面
- 如果需要传递多个参数,那么通过空格的方式进行分隔。
图书详情页面
2.6 spaceless 标签
移除html标签中的空白字符。包括空格、tab键、换行等。示例代码如下:
{% spaceless %}
{% endspaceless %}
那么在渲染完成后,会变成以下的代码:
spaceless 只会移除html标签之间的空白字符。而不会移除标签与文本之间的空白字符。看以 下代码:
{% spaceless %}
Hello
{% endspaceless %}
这个将不会移除 strong 中的空白字符。
2.7 autoescape 标签
开启和关闭这个标签内元素的自动转义功能。自动转义是可以将一些特殊 的字符。比如 < 转义成 html 语法能识别的字符,会被转义成 < ,而 > 会被自动转义 成 > 。模板中默认是已经开启了自动转义的。 autoescape 的示例代码如下:
# 传递的上下文信息
context = {
"info":"百度"
}
# 模板中关闭自动转义
{% autoescape off %}
{{ info }}
{% endautoescape %}
那么就会显示百度的一个超链接。如果把 off 改成 on ,那么就会显示成一个普通的字符
串。示例代码如下:
{% autoescape on %}
{{ info }}
{% endautoescape %}
2.8 verbatim 标签
默认在 DTL 模板中是会去解析那些特殊字符的。比如 {% 和 %} 以及 {{ 等。如果你在某个代码片段中不想使用 DTL 的解析引擎。那么你可以把这个代码片段放在 verbatim 标签中。示例代码下:
{% verbatim %}
{{if dying}}Still alive.{{/if}}
{% endverbatim %}