django template

模板是一个文本，用于分离文档的表现形式和内容。 模板定义了占位符以及各种用于规范文档该如何显示的各部分基本逻辑（模板标签）。 模板通常用于产生HTML，但是Django的模板也能产生任何基于文本格式的文档。

用两个大括号括起来的文字（例如 {{ person_name }} ）称为 变量(variable) 。这意味着在此处插入指定变量的值。 如何指定变量的值呢？ 稍后就会说明。

被大括号和百分号包围的文本(例如 {% if ordered_warranty %} )是 模板标签(template tag) 。标签(tag)定义比较明确，即： 仅通知模板系统完成某些工作的标签。

这个例子中的模板包含一个for标签（ {% for item in item_list %} ）和一个if 标签（{% if ordered_warranty %} ）

for标签类似Python的for语句，可让你循环访问序列里的每一个项目。 if 标签，正如你所料，是用来执行逻辑判断的。 在这里，tag标签检查ordered_warranty值是否为True。如果是，模板系统将显示{% if ordered_warranty %}和{% else %}之间的内容；否则将显示{% else %}和{% endif %}之间的内容。{% else %}是可选的。

最后，这个模板的第二段中有一个关于filter过滤器的例子，它是一种最便捷的转换变量输出格式的方式。 如这个例子中的{{ship_date|date:”F j, Y” }}，我们将变量ship_date传递给date过滤器，同时指定参数”F j,Y”。date过滤器根据参数进行格式输出。 过滤器是用管道符(|)来调用的，具体可以参见Unix管道符。

在Python代码中使用Django模板的最基本方式如下：

1.可以用原始的模板代码字符串创建一个 Template 对象， Django同样支持用指定模板文件路径的方式来创建 Template 对象;

2.调用模板对象的render方法，并且传入一套变量context。它将返回一个基于模板的展现字符串，模板中的变量和标签会被context值替换。

转到project目录（在第二章由 django-admin.py startproject 命令创建）， 输入命令 python manage.py shell 启动交互界面。

系统会在下面的情形抛出 TemplateSyntaxError 异常：

无效的tags

标签的参数无效

无效的过滤器

过滤器的参数无效

无效的模板语法

未封闭的块标签 （针对需要封闭的块标签）

模板渲染

一旦你创建一个 Template 对象，你可以用 context 来传递数据给它。 一个context是一系列变量和它们值的集合。

context在Django里表现为 Context 类，在 django.template 模块里。 她的构造函数带有一个可选的参数： 一个字典映射变量和它们的值。 调用 Template 对象 的 render() 方法并传递context来填充模板：

from django.template import Context, Template
t = Template(‘My name is {{ name }}.’)
c = Context({‘name’: ‘Stephane’})
t.render(c)
u’My name is Stephane.’

我们在模板对象上调用 render() 方法，传递 context参数给它。 这是返回渲染后的模板的方法，它会替换模板变量为真实的值和执行块标签。

使用Django模板系统的基本规则： 写模板，创建 Template 对象，创建 Context ， 调用 render() 方法。

Django 模板解析非常快捷。 大部分的解析工作都是在后台通过对简短正则表达式一次性调用来完成。 这和基于 XML 的模板引擎形成鲜明对比，那些引擎承担了 XML 解析器的开销，且往往比 Django 模板渲染引擎要慢上几个数量级。

Bad

for name in (‘John’, ‘Julie’, ‘Pat’):
t = Template(‘Hello, {{ name }}’)
print t.render(Context({‘name’: name}))

Good

t = Template(‘Hello, {{ name }}’)
for name in (‘John’, ‘Julie’, ‘Pat’):
print t.render(Context({‘name’: name}))

当模板系统在变量名中遇到点时，按照以下顺序尝试进行查找：

字典类型查找 （比如 foo[“bar”] )

属性查找 (比如 foo.bar )

方法调用 （比如 foo.bar() )

列表类型索引查找 (比如 foo[bar] )

在方法查找过程中，如果某方法抛出一个异常，除非该异常有一个 silent_variable_failure 属性并且值为 True ，否则的话它将被传播。如果异常被传播，模板里的指定变量会被置为空字符串，比如:

t = Template(“My name is {{ person.first_name }}.”)
class PersonClass3:
… def first_name(self):
… raise AssertionError, “foo”
p = PersonClass3()
t.render(Context({“person”: p}))
Traceback (most recent call last):
…
AssertionError: foo

class SilentAssertionError(AssertionError):
… silent_variable_failure = True
class PersonClass4:
… def first_name(self):
… raise SilentAssertionError
p = PersonClass4()
t.render(Context({“person”: p}))
u’My name is .’

认情况下，如果一个变量不存在，模板系统会把它展示为空字符串，不做任何事情来表示失败。

在每个{% for %}循环里有一个称为forloop 的模板变量。这个变量有一些提示循环进度信息的属性。

forloop.counter 总是一个表示当前循环的执行次数的整数计数器。 这个计数器是从1开始的，所以在第一次循环时 forloop.counter 将会被设置为1。

{% for item in todo_list %}

{{ forloop.counter }}: {{ item }}

{% endfor %}
forloop.counter0 类似于 forloop.counter ，但是它是从0计数的。 第一次执行循环时这个变量会被设置为0。

forloop.revcounter 是表示循环中剩余项的整型变量。 在循环初次执行时 forloop.revcounter 将被设置为序列中项的总数。 最后一次循环执行中，这个变量将被置1。

forloop.revcounter0 类似于 forloop.revcounter ，但它以0做为结束索引。 在第一次执行循环时，该变量会被置为序列的项的个数减1。

forloop.first 是一个布尔值，如果该迭代是第一次执行，那么它被置为““ 在下面的情形中这个变量是很有用的：

System Message: WARNING/2 (, line 1071); backlink

Inline literal start-string without end-string.

{% for object in objects %}
{% if forloop.first %}

• {% else %}
• {% endif %}
  {{ object }}
  
• {% endfor %}
  forloop.last 是一个布尔值；在最后一次执行循环时被置为True。 一个常见的用法是在一系列的链接之间放置管道符（|）

  {% for link in links %}{{ link }}{% if not forloop.last %} | {% endif %}{% endfor %}
  上面的模板可能会产生如下的结果：

  Link1 | Link2 | Link3 | Link4
  另一个常见的用途是为列表的每个单词的加上逗号。

  Favorite places:
  {% for p in places %}{{ p }}{% if not forloop.last %}, {% endif %}{% endfor %}
  forloop.parentloop 是一个指向当前循环的上一级循环的 forloop 对象的引用（在嵌套循环的情况下）。 例子在此：

  {% for country in countries %}
  

  
  {% for city in country.city_list %}
  
  
  
  
  
  {% endfor %}
  

  Country #{{ forloop.parentloop.counter }}

  City #{{ forloop.counter }}

  {{ city }}

  
  {% endfor %}
  forloop 变量仅仅能够在循环中使用。 在模板解析器碰到{% endfor %}标签后，forloop就不可访问了。

  Context和forloop变量

  在一个 {% for %} 块中，已存在的变量会被移除，以避免 forloop 变量被覆盖。 Django会把这个变量移动到 forloop.parentloop 中。通常我们不用担心这个问题，但是一旦我们在模板中定义了 forloop 这个变量（当然我们反对这样做），在 {% for %} 块中它会在 forloop.parentloop 被重新命名。

  模板自加载与模板目录
  注意django模板的目录添加在这里：
  TEMPLATES = [
  {
  ‘BACKEND’: ‘django.template.backends.django.DjangoTemplates’,
  ‘DIRS’: [‘./mysite/templates’,],
  ‘APP_DIRS’: True,
  ‘OPTIONS’: {
  ‘context_processors’: [
  ‘django.template.context_processors.debug’,
  ‘django.template.context_processors.request’,
  ‘django.contrib.auth.context_processors.auth’,
  ‘django.contrib.messages.context_processors.messages’,
  ],
  },
  },
  ]

  使用继承的一种常见方式是下面的三层法：

  创建 base.html 模板，在其中定义站点的主要外观感受。 这些都是不常修改甚至从不修改的部分。

  为网站的每个区域创建 base_SECTION.html 模板(例如, base_photos.html 和 base_forum.html )。这些模板对 base.html 进行拓展，并包含区域特定的风格与设计。

  为每种类型的页面创建独立的模板，例如论坛页面或者图片库。 这些模板拓展相应的区域模板。