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