模板(template)包含与继承

  Django 模板查找机制: Django 查找模板的过程是在每个 app 的 templates 文件夹中找(而不只是当前 app 中的代码只在当前的 app 的 templates 文件夹中找)。各个 app 的 templates 形成一个文件夹列表,Django 遍历这个列表,一个个文件夹进行查找,当在某一个文件夹找到的时候就停止,所有的都遍历完了还找不到指定的模板的时候就是 Template Not Found (过程类似于Python找包)。这样设计有利当然也有弊,有利是的地方是一个app可以用另一个app的模板文件,弊是有可能会找错了。所以我们使用的时候在 templates 中建立一个 app 同名的文件夹,这样就好了。

  这就需要把每个app中的 templates 文件夹中再建一个 app 的名称,仅和该app相关的模板放在 app/templates/app/ 目录下面。

  例:aptest/templates/aptest,模板调用:return render(request,'aptest/hours_ahead.html',context)

 

项目aptest下的templates文件夹用于存放所有模板:

base.html,header.html,footer.html放于templates目录下

current_datetime.html,hours_ahead.html放于templates/aptest目录下

base.html:定义了一个简单的 HTML 框架文档,该站点下所有项目都将使用

<!-- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head> -->  <!--注释掉该部分内容,使用header.html中的内容替代 -->
{% include 'header.html' %} <!-- include的.html要与其位于同一目录下 -->
    <title>{% block title %}{% endblock %}</title>   <!--  {% block %} 标签告诉模板引擎,子模板可以重载这些部分。 每个{% block %}标签所要做的是告诉模板引擎,该模板下的这一块内容将有可能被子模板覆盖。 -->
</head>
<body>
    <h1>My helpful timestamp site</h1>
    {% block content %}{% endblock %}
    {% block footer %}   <!-- 由于子模板并没有定义 footer 块,模板系统将使用在父模板中定义的值。 父模板 {% block %} 标签中的内容总是被当作一条退路。-->
    <hr>
    <p>Thanks for visiting my site2.</p>
    {% endblock %}
    <!-- {% include 'footer.html' %} -->
</body>
</html>

header.html内容:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head>

footer.html内容:(该base.html中未调用)

    <hr>
    <p>Thanks for visiting my siteffffff.</p>
</body>
</html>

current_datetime.html内容:

{% extends "base.html" %} <!-- 注明扩展base.html -->

{% block title %}The current time{% endblock %} <!-- 扩展base中的block title部分 -->

{% block content %}  <!-- 扩展base中的block content部分 -->
<p>It is now current_aadate.</p>
{% endblock %}

hours_ahead.html内容:

{% extends "base.html" %}

{% block title %}Future time{% endblock %}

{% block content %}
<p>In {{ hour_offset }} hour(s), it will be  next_time .</p>
{% endblock %}

最后在view中渲染current_datetime.html,hours_ahead.html,分别显示如下:

from:http://djangobook.py3k.cn/2.0/chapter04/

可以根据需要使用任意多的继承次数。 使用继承的一种常见方式是下面的三层法:

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

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

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

这个方法可最大限度地重用代码,并使得向公共区域(如区域级的导航)添加内容成为一件轻松的工作。

以下是使用模板继承的一些诀窍:

如果在模板中使用 {% extends %} ,必须保证其为模板中的第一个模板标记。 否则,模板继承将不起作用。3

一般来说,基础模板中的 {% block %} 标签越多越好。 记住,子模板不必定义父模板中所有的代码块,因此你可以用合理的缺省值对一些代码块进行填充,然后只对子模板所需的代码块进行(重)定义。 俗话说,钩子越多越好。4

如果发觉自己在多个模板之间拷贝代码,你应该考虑将该代码段放置到父模板的某个 {% block %} 中。

如果你需要访问父模板中的块的内容,使用 {{ block.super }}这个标签吧,这一个魔法变量将会表现出父模板中的内容。 如果只想在上级代码块基础上添加内容,而不是全部重载,该变量就显得非常有用了。14

不允许在同一个模板中定义多个同名的 {% block %} 。 存在这样的限制是因为block 标签的工作方式是双向的。 也就是说,block 标签不仅挖了一个要填的坑,也定义了在父模板中这个坑所填充的内容。如果模板中出现了两个相同名称的 {% block %} 标签,父模板将无从得知要使用哪个块的内容。4

{% extends %} 对所传入模板名称使用的加载方法和 get_template() 相同。 也就是说,会将模板名称被添加到 TEMPLATE_DIRS 设置之后。3

多数情况下, {% extends %} 的参数应该是字符串,但是如果直到运行时方能确定父模板名,这个参数也可以是个变量。 这使得你能够实现一些很酷的动态功能。

 

原文地址:https://www.cnblogs.com/dreamer-fish/p/5417190.html