Django web框架之模板继承
2017-10-31 19:04
597 查看
模板继承 (extend)
Django模版引擎中最强大也是最复杂的部分就是模版继承了。模版继承可以让您创建一个基本的“骨架”模版,它包含您站点中的全部元素,并且可以定义能够被子模版覆盖的 blocks 。
通过从下面这个例子开始,可以容易的理解模版继承:
<!DOCTYPE html> <html lang="en"> <head> <link rel="stylesheet" href="style.css" /> <title>{% block title %}My amazing site{%/span> endblock %}</title> </head> <body> <div id="sidebar"> {% block sidebar %} <ul> <li><a href="/">Home</a></li> <li><a href="/blog/">Blog</a></li> </ul> {% endblock %} </div> <div id="content"> {% block content %}{% endblock %} </div> </body> </html>
这个模版,我们把它叫作
base.html, 它定义了一个可以用于两列排版页面的简单HTML骨架。“子模版”的工作是用它们的内容填充空的blocks。
在这个例子中,
block标签定义了三个可以被子模版内容填充的block。
block告诉模版引擎: 子模版可能会覆盖掉模版中的这些位置。
子模版可能看起来是这样的:
extends标签是这里的关键。它告诉模版引擎,这个模版“继承”了另一个模版。当模版系统处理这个模版时,首先,它将定位父模版——在此例中,就是“base.html”。
那时,模版引擎将注意到
base.html中的三个
block标签,并用子模版中的内容来替换这些block。根据
blog_entries的值,输出可能看起来是这样的:
请注意,子模版并没有定义
sidebarblock,所以系统使用了父模版中的值。父模版的
{% block %}标签中的内容总是被用作备选内容(fallback)。
这种方式使代码得到最大程度的复用,并且使得添加内容到共享的内容区域更加简单,例如,部分范围内的导航。
这里是使用继承的一些提示:
-
如果你在模版中使用
{% extends %}
标签,它必须是模版中的第一个标签。其他的任何情况下,模版继承都将无法工作。 -
在base模版中设置越多的
{% block %}
标签越好。请记住,子模版不必定义全部父模版中的blocks,所以,你可以在大多数blocks中填充合理的默认内容,然后,只定义你需要的那一个。多一点钩子总比少一点好。 -
如果你发现你自己在大量的模版中复制内容,那可能意味着你应该把内容移动到父模版中的一个
{% block %}
中。 -
If you need to get the content of the block from the parent template, the
{{ block.super }}
variable will do the trick. This is useful if you want to add to the contents of a parent block instead of completely overriding it. Data inserted using{{ block.super }}
will not be automatically escaped (see the next section), since it was already escaped, if necessary, in the parent template. -
为了更好的可读性,你也可以给你的
{% endblock %}
标签一个 名字 。例如:在大型模版中,这个方法帮你清楚的看到哪一个
{% block %}
标签被关闭了。
最后,请注意您并不能在一个模版中定义多个相同名字的
block标签。这个限制的存在是因为block标签的作用是“双向”的。这个意思是,block标签不仅提供了一个坑去填,它还在 _父模版_中定义了填坑的内容。如果在一个模版中有两个名字一样的
block标签,模版的父模版将不知道使用哪个block的内容。
相关文章推荐
- Python3之Django Web框架模板继承篇
- python web框架Django学习(四)模板查找机制
- Django web框架之模板
- Django框架之模板继承和静态文件配置
- python web框架Django学习(五)模板中的循环,条件判断,常用的标签,过滤器的使用
- Python中使用django框架进行web开发,模板中无法导入css、js和图片的问题解决
- python下的web开发框架-Django,django模板的使用
- python下的web开发框架-Django,django模板的使用
- py库: django (web框架)
- Python -----Web----Django模板系统
- 在IIS上部署基于django WEB框架的python网站应用
- Python web框架Django(一)
- [py]django模板继承
- 详解Django框架中用context来解析模板的方法
- Python3之Django Web框架分页多页码处理一
- python Web框架 Django学习(2)
- Web开发之Django框架的学习(2)
- python的web开发框架django学习笔记
- 全面解读Python Web开发框架Django
- Django框架全面讲解 -- 模板