在视图中使用模板2
前序
在学习了模板系统的基础之后,现在让我们使用相关知识来创建视图。
先看一下没有使用template的视图代码
from django.http import HttpResponse
import datetime
def current_datetime(request):
now = datetime.datetime.now()
html = "<html><body>It is now %s.</body></html>" % now
return HttpResponse(html)
用 Django模板系统来修改该视图。
step 1 添加模板路径
在settings.py中找到
TEMPLATE_DIRS = (
# Put strings here, like "/home/html/django_templates" or "C:/www/django/templates".
# Always use forward slashes, even on Windows.
# Don't forget to use absolute paths, not relative paths.
)
把配置改成(如果没有这个参数 ,直接添加):
TEMPLATE_DIRS = (
'E:/python_workspace/sfweb/sfweb/books/templates',
)
或者:
import os.path
TEMPLATE_DIRS = (
os.path.join(os.path.dirname(__file__), 'templates').replace('\\','/'),
)
下面是一些注意事项:
- Python 要求单元素元组中必须使用逗号,以此消除与圆括号表达式之间的歧义
- Windows 平台,驱动器符号也要使用Unix风格的斜杠(/)而不是反斜杠
step 2 修改视图代码
返回 current_datetime 视图,进行如下修改:
from django.shortcuts import render ,render_to_response
from django.http import HttpResponse
from django.template.loader import get_template
#from django.template import Context,Template
import datetime
def current_datetime(request):
now = datetime.datetime.now()
# t = get_template("ctime.html") ##get_template() 方法可以直接得到Template 实例
#ctx = Context({'now':now})
#html = t.render({'now':now})
return render_to_response("ctime.html", locals()) # render_to_response 封装了get_template()方法,
注意:
- locals() 返回所有局部变量的名称与值进行映射。
- 如果 get_template() 找不到给定名称的模板,将会引发一个 TemplateDoesNotExist 异常
step 3 创建模板
在模板目录E:/python_workspace/sfweb/sfweb/books/templates 创建 current_datetime.html 文件
内容:
<html><body>It is now {{ current_date }}.</body></html>
高级模板
1 内建模板标签
{% include ‘current_datetime.html ’ %} :在新的html中嵌入current_datetime.html
2 模板继承
本质上来说,模板继承就是先构造一个基础框架模板,而后在其子模板中对它所包含站点公用部分和定义块进行重载。
第一步是定义 基础模板 , 该框架之后将由 子模板 所继承。 以下是我们目前所讲述范例的基础模板:9
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head>
<title>{% block title %}{% endblock %}</title>
</head>
<body>
<h1>My helpful timestamp site</h1>
{% block content %}{% endblock %}
{% block footer %}
<hr>
<p>Thanks for visiting my site.</p>
{% endblock %}
</body>
</html>
{% block %}标签所要做的是告诉模板引擎,该模板下的这一块内容将有可能被子模板覆盖
现在我们已经有了一个基本模板,我们可以修改 current_datetime.html 模板来继承base.html
{% extends "base.html" %}
{% block title %}The current time{% endblock %}
{% block content %}
<p>It is now {{ current_date }}.</p>
{% endblock %}
模板引擎发现了 {% extends %} 标签, 注意到该模板是一个子模板。 模板引擎立即装载其父模板,即本例中的 base.html 。
你可以根据需要使用任意多的继承次数。 使用继承的一种常见方式是下面的三层法:
- 创建 base.html 模板,在其中定义站点的主要外观感受。 这些都是不常修改甚至从不修改的部分。
- 为网站的每个区域创建 base_SECTION.html 模板(例如, base_photos.html 和
base_forum.html )。这些模板对 base.html 进行拓展,并包含区域特定的风格与设计 - 为每种类型的页面创建独立的模板,例如论坛页面或者图片库。 这些模板拓展相应的区域模板。
以下是使用模板继承的一些诀窍:
如果在模板中使用 {% extends %} ,必须保证其为模板中的第一个模板标记。 否则,模板继承将不起作用。3
一般来说,基础模板中的 {% block %} 标签越多越好。 记住,子模板不必定义父模板中所有的代码块,因此你可以用合理的缺省值对一些代码块进行填充,然后只对子模板所需的代码块进行(重)定义。 俗话说,钩子越多越好。4
如果发觉自己在多个模板之间拷贝代码,你应该考虑将该代码段放置到父模板的某个 {% block %} 中。
如果你需要访问父模板中的块的内容,使用 {{ block.super }}这个标签吧,这一个魔法变量将会表现出父模板中的内容。 如果只想在上级代码块基础上添加内容,而不是全部重载,该变量就显得非常有用了。17
不允许在同一个模板中定义多个同名的 {% block %} 。 存在这样的限制是因为block 标签的工作方式是双向的。 也就是说,block 标签不仅挖了一个要填的坑,也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个相同名称的 {% block %} 标签,父模板将无从得知要使用哪个块的内容。4
{% extends %} 对所传入模板名称使用的加载方法和 get_template() 相同。 也就是说,会将模板名称被添加到 TEMPLATE_DIRS 设置之后。4
多数情况下, {% extends %} 的参数应该是字符串,但是如果直到运行时方能确定父模板名,这个参数也可以是个变量。 这使得你能够实现一些很酷的动态功能。