Django模板语言详解
阅读: 50775
评论:13
本节将介绍Django模版系统的语法。Django模版语言致力于在性能和简单性上取得平衡。
如果你有过其它编程背景,或者使用过一些在HTML中直接混入程序代码的语言,那么你需要记住,Django的模版系统并不是简单的将Python嵌入到HTML中。
一、模板
模版是纯文本文件,可以生成任何基于文本的文件格式,比如HTML,XML,CSV等。
下面是一个小模版,它展示了一些基本的元素。
{% extends "base_generic.html" %}
{% block title %}{ { section.title }}{% endblock %}
{% block content %}
{% for story in story_list %}
{ { story.headline|upper }}
{ { story.tease|truncatewords:"100" }}
{% endfor %}
{% endblock %}
二、变量
变量看起来就像是这样: { { variable }}。
当模版引擎遇到一个变量,它将从上下文context中获取这个变量的值,然后用值替换掉它本身。
变量的命名包括任何字母数字以及下划线("_")的组合,最重要的是,变量名称中不能有空格或标点符号。
当模版系统渲染变量的时候遇到点("."),它将以这样的顺序查询这个圆点具体代表的功能:
字典查询(Dictionary lookup)
属性或方法查询(Attribute or method lookup)
数字索引查询(Numeric index lookup)
如果你使用的变量不存在,模版系统将插入string_if_invalid选项的值,默认设置为''(空字符串)。
注意,像{ { foo.bar }}这种模版表达式中的“bar”,如果在模版上下文中存在,将解释为一个字面意义的字符串而不是使用变量bar的值 。
三、过滤器
过滤器看起来是这样的:{ { name | lower }}。使用管道符号(|)来应用过滤器。该过滤器将文本转换成小写。
过滤器可以“链接”。一个过滤器的输出应用于下一个过滤器。例如:{ { text|escape|linebreaks }}就是一个常用的过滤器链,它首先转移文本内容,然后把文本行转成
标签。
一些过滤器带有参数。 过滤器的参数看起来像是这样: { { bio|truncatewords:30 }}。 这将显示bio变量的前30个词。
过滤器参数包含空格的话,必须用引号包起来。例如,使用逗号和空格去连接一个列表中的元素,你需要使用{ { list|join:", " }}。
Django提供了大约六十个内置的模版过滤器,很多时候你想要的功能,它都已经提供了,经常查看这些过滤器,发现新大陆吧。下面是一些常用的模版过滤器:
1. default
为false或者空变量提供默认值,像这样:
{ { value|default:"nothing" }}
2. length
返回值的长度。它对字符串和列表都起作用。
{ { value|length }}
如果value是['a', 'b', 'c', 'd'],那么输出4。
3. filesizeformat
格式化为“人类可读”文件大小单位(即'13 KB',4.1 MB','102 bytes'等)。
{ { value|filesizeformat }}
如果value是123456789,输出将会是117.7MB。
我们可以创建自定义的模板过滤器和标签,这是最终极的武器。
四、标签
标签看起来像是这样的: {% tag %}。
标签比变量复杂得多,有些用于在输出中创建文本,有些用于控制循环或判断逻辑,有些用于加载外部信息到模板中供以后的变量使用。
一些标签需要开始和结束标签(即 {% 标签 %} ... 标签 内容 ... {% ENDTAG %})。
Django自带了大约24个内置的模版标签。下面是一些常用的标签:
1. for循环标签
循环对象中每个元素。需要结束标签{% endfor %} 。例如,显示athlete_list中提供的运动员列表:
{% for athlete in athlete_list %}
{ { athlete.name }}{% endfor %}
2. if,elif和else标签
计算一个表达式,并且当表达式的值是“True”时,显示块中的内容。需要{% endif %}结束标签。整体逻辑非常类似Python的if、elif和else,如下所示。:
{% 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 }}。否则,如果athlete_in_locker_room_list不为空,将显示“Athletes should be