{{ name }} 变量
{% if or for %} 模板标签
模板的创建
- 可以用原始的模板代码字符串创建一个 Template 对象, Django同样支持用指定模板文件路径的方式来创建 Template 对象;
- 调用模板对象的render方法,并且传入一套变量context。它将返回一个基于模板的展现字符串,模板中的变量和标签会被context值替换。
Django模板系统的基本规则: 写模板,创建 Template 对象,创建 Context , 调用 render() 方法。
模板中调用方法:注意这里调用方法时并* 没有* 使用圆括号 而且也无法给该方法传递参数;你只能调用不需参数的方法。
当模板系统在变量名中遇到点时,按照以下顺序尝试进行查找:
- § 字典类型查找 (比如 foo["bar"] )
- § 属性查找 (比如 foo.bar )
- § 方法调用 (比如 foo.bar() )
- § 列表类型索引查找 (比如 foo[bar] )
Context对象可以像字典一样操作
if 标签
在Python和Django模板系统中,以下这些对象相当于布尔值的False
- § 空列表([] )
- § 空元组(() )
- § 空字典({} )
- § 空字符串('' )
- § 零值(0 )
- § 特殊对象None
- § 对象False(很明显)
- § 提示:你也可以在自定义的对象里定义他们的布尔值属性(这个是python的高级用法)。
除以上几点以外的所有东西都视为`` True``
{% if %} 标签不允许在同一个标签中同时使用 and 和 or ,因为逻辑上可能模糊的,系统不支持用圆括号来组合比较操作。
多次使用同一个逻辑操作符是没有问题的。
一定要用 {% endif %} 关闭每一个 {% if %} 标签。
for 标签
给标签增加一个 reversed 使得该列表被反向迭代
所以`` for`` 标签支持一个可选的`` {% empty %}`` 分句,用于输出列表为空时的错误信息
forloop变量
- forloop.counter 循环次数,从1开始
- forloop.counter0 循环次数,从0开始
- forloop.revcounter 循环剩余的次数,最后一次为1
- forloop.revcounter0 循环剩余的次数,最后一次为0
- forloop.first 迭代第一次执行时为Ture,其余为False
- forloop.last 迭代最后一次为Ture
- forloop.parentloop 是一个指向当前循环的上一级循环的 forloop 对象的引用(在嵌套循环的情况下)
{% ifequal %} 标签比较两个值
只有模板变量,字符串,整数和小数可以作为 {% ifequal %} 标签的参数
Django模板语言同样提供代码注释。 注释使用 {# #}
实现多行注释,可以使用`` {% comment %}`` 模板标签
过滤器
- addslashes : 添加反斜杠到任何反斜杠、单引号或者双引号前面
- date : 按指定的格式字符串参数格式化 date 或者 datetime 对象
- length : 返回变量的长度
加载模板
django.template.loader.get_template() 读取模板文件,返回Template对象
locals() 它返回的字典对所有局部变量的名称与值进行映射
{% include 'include/nav.html' %} 该标签允许在(模板中)包含其它的模板的内容
{% block %} 标签告诉模板引擎,子模板可以重载这些部分
{% extends %} 继承模板
继承的一种常见方式是下面的三层法
- 创建 base.html 模板,在其中定义站点的主要外观感受。 这些都是不常修改甚至从不修改的部分。
- 为网站的每个区域创建 base_SECTION.html 模板(例如, base_photos.html 和 base_forum.html )。这些模板对 base.html 进行拓展,并包含区域特定的风格与设计。
- 为每种类型的页面创建独立的模板,例如论坛页面或者图片库。 这些模板拓展相应的区域模板。
这个方法可最大限度地重用代码,并使得向公共区域(如区域级的导航)添加内容成为一件轻松的工作。
以下是使用模板继承的一些诀窍:
- § 如果在模板中使用 {% extends %} ,必须保证其为模板中的第一个模板标记。 否则,模板继承将不起作用。
- § 一般来说,基础模板中的 {% block %} 标签越多越好。记住,子模板不必定义父模板中所有的代码块,因此你可以用合理的缺省值对一些代码块进行填充,然后只对子模板所需的代码块进行(重)定义。 俗话说,钩子越多越好。
- § 如果发觉自己在多个模板之间拷贝代码,你应该考虑将该代码段放置到父模板的某个 {% block %} 中。
- § 如果你需要访问父模板中的块的内容,使用 {{ block.super }}这个标签吧,这一个魔法变量将会表现出父模板中的内容。 如果只想在上级代码块基础上添加内容,而不是全部重载,该变量就显得非常有用了。
- § 不允许在同一个模板中定义多个同名的 {% block %} 。 存在这样的限制是因为block 标签的工作方式是双向的。 也就是说,block 标签不仅挖了一个要填的坑,也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个相同名称的 {% block %} 标签,父模板将无从得知要使用哪个块的内容。
- § {% extends %} 对所传入模板名称使用的加载方法和 get_template() 相同。 也就是说,会将模板名称被添加到 TEMPLATE_DIRS 设置之后。
- 多数情况下, {% extends %} 的参数应该是字符串,但是如果直到运行时方能确定父模板名,这个参数也可以是个变量。 这使得你能够实现一些很酷的动态功能。