20121024 The django book 笔记 模板

{{ 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 %} 的参数应该是字符串，但是如果直到运行时方能确定父模板名，这个参数也可以是个变量。 这使得你能够实现一些很酷的动态功能。