注:以下内容转载自 现代魔法学院 网站的 如何使用Django模板系统 一文,仅供学习使用。
前面我们大概了解了下 Django 的模板系统,接下来,我们看看怎么去使用它。
我们先要明白它是如何工作的。我们暂不打算将它与先前创建的视图结合在一起,因为我们现在的目的是了解它是如何独立工作的。换言之,通常你会将模板和视图一起使用,但是我们只是想突出模板系统是一个 Python 库,你可以在任何地方使用它,而不仅仅是在 Django 视图中。
在 Python 代码中使用 Django 模板的最基本方式如下:
- 可以用原始的模板代码字符串创建一个 Template 对象, Django 同样支持用指定模板文件路径的方式来创建 Template 对象;
- 调用模板对象的 render 方法,并且传入一套变量 context。它将返回一个基于模板的展现字符串,模板中的变量和标签会被 context 值替换。
代码如下:
>>> from django import template
>>> t = template.Template('My name is {{ name }}.')
>>> c = template.Context({'name': 'Adrian'})
>>> print t.render(c)
My name is Adrian.
>>> c = template.Context({'name': 'Fred'})
>>> print t.render(c)
My name is Fred.
就这样,下面我们详细介绍上面这段代码的含义:
创建模板对象
创建一个 Template 对象最简单的方法就是直接实例化它。Template 类就在 django.template 模块中,构造函数接受一个参数,原始模板代码。让我们深入挖掘一下 Python的解释器看看它是怎么工作的。
转到 project 目录(由 django-admin.py startproject 命令创建),输入命令 python manage.py shell 启动交互界面。
如果你曾经使用过 Python,你一定好奇,为什么我们运行 python manage.py shell 而不是 python。
这两个命令都会启动交互解释器,但是 manage.py shell 命令有一个重要的不同:在启动解释器之前,它告诉 Django 使用哪个设置文件。Django 框架的大部分子系统,包括模板系统,都依赖于配置文件;如果 Django 不知道使用哪个配置文件,这些系统将不能工作。
如果你想知道,这里将向你解释它背后是如何工作的。Django 搜索 DJANGO_SETTINGS_MODULE 环境变量,它被设置在 settings.py中。例如,假设 mysite 在你的 Python 搜索路径中,那么 DJANGO_SETTINGS_MODULE 应该被设置为:‘mysite.settings’。
当你运行命令:python manage.py shell,它将自动帮你处理 DJANGO_SETTINGS_MODULE。在当前的这些示例中,我们鼓励你使用 “python manage.py shell” 这个方法,这样可以免去你大费周章地去配置那些你不熟悉的环境变量。
随着你越来越熟悉 Django,你可能会偏向于废弃使用 “manage.py shell”,而是在你的配置文件 .bash_profile 中手动添加 DJANGO_SETTINGS_MODULE 这个环境变量。如果你更喜欢 idle,可以试着自己配置。
让我们来了解一些模板系统的基本知识:
>>> from django.template import Template
>>> t = Template('My name is {{ name }}.')
>>> print t
如果你跟我们一起做,你将会看到下面的内容:
<django.template.Template object at 0xb7d5f24c>
0xb7d5f24c 每次都会不一样,这没什么关系;这只是Python运行时 Template 对象的 ID。
当你创建一个 Template 对象,模板系统在内部编译这个模板到内部格式,并做优化,做好渲染的准备。如果你的模板语法有错误,那么在调用 Template() 时就会抛出 TemplateSyntaxError 异常:
>>> from django.template import Template
>>> t = Template('{% notatag %}')
Traceback (most recent call last):
File "<stdin>", line 1, in ?
...
django.template.TemplateSyntaxError: Invalid block tag: 'notatag'
这里,块标签(block tag)指向的是”{% notatag %}“,块标签与模板标签是同义的。
系统会在下面的情形抛出 TemplateSyntaxError 异常:
- 无效的tags
- 标签的参数无效
- 无效的过滤器
- 过滤器的参数无效
- 无效的模板语法
- 未封闭的块标签 (针对需要封闭的块标签)
下一小节再介绍模板渲染。