“{%扩展%}”和“{%包括%}”在 Django 模板中

Question

我想在两个不同的基本文件中提供相同的内容。

所以，我试图这样做：

page1.html:

{% extends "base1.html" %}
{% include "commondata.html" %}

page2.html:

{% extends "base2.html" %} 
{% include "commondata.html" %}

问题是我似乎无法同时使用扩展和包含。有什么办法可以做到这一点吗？如果没有，我怎样才能实现上述目标？

commondata.html 覆盖 base1.html 和 base2.html 中指定的块。

这样做的目的是在pdf 和 html 格式，格式略有不同。上面的问题简化了我想要做的事情，所以如果我能得到答案，它将解决我的问题。

Answer 1

当您使用扩展模板标签时，您是在说当前模板扩展了另一个模板——它是一个子模板，依赖于父模板。 Django 将查看您的子模板并使用其内容来填充父模板。

您想要在子模板中使用的所有内容都应该在块内，Django 使用这些块来填充父模板。如果您想在该子模板中使用 include 语句，则必须将其放在一个块中，以便 Django 能够理解它。否则它就没有意义，Django 也不知道如何处理它。

Django 文档有一些使用块替换父模板中的块的非常好的示例。

https://docs.djangoproject.com/en/dev/参考/模板/语言/#template-inheritance

Answer 2

来自 Django 文档：

include 标签应被视为“呈现此子模板并包含 HTML”的实现，而不是“解析此子模板并包含其内容，就好像它是父模板的一部分一样”。这意味着包含的模板之间没有共享状态——每个包含都是一个完全独立的渲染过程。

因此 Django 不会从 commondata.html 中获取任何块，并且它不知道如何处理块之外渲染的 html。

Answer 3

这应该可以解决您的问题：将 include 标记放在块部分内。

页面1.html：

{% extends "base1.html" %}

{% block foo %}
   {% include "commondata.html" %}
{% endblock %}

页面2.html：

{% extends "base2.html" %}

{% block bar %}
   {% include "commondata.html" %}
{% endblock %}

Answer 4

有关它为什么对我不起作用的更多信息，以防它对未来的人有帮助：

它不起作用的原因是 django 中的 {% include %} 不喜欢像花哨的撇号这样的特殊字符。我试图包含的模板数据是从word粘贴的。我必须手动删除所有这些特殊字符，然后它才能成功包含。

Answer 5

添加以供将来通过 google 找到此内容的人参考：对于此类情况，您可能需要查看夹层库提供的 {% overextend %} 标记。

Answer 6

您无法将包含文件中的块拉入子模板中以覆盖父模板的块。但是，您可以在变量中指定父级，并在上下文中指定基本模板。

来自文档：

{%extendsvariable%} 使用变量的值。如果变量的计算结果为字符串，Django 将使用该字符串作为父模板的名称。如果变量计算结果为 Template 对象，Django 将使用该对象作为父模板。

不要将“page1.html”和“page2.html”分开，而是将 {% extends base_template %} 放在“commondata.html”的顶部。然后在您的视图中，将 base_template 定义为“base1.html”或“base2.html”。

Answer 7

2015 年 12 月 10 日编辑：正如评论中指出的，ssi 自 1.8 版以来已被弃用。根据文档：

此标签已被弃用，并将在 Django 1.10 中删除。请改用 include 标签。

---

在我看来，这个问题的正确（最佳）答案是来自 podshumok 的答案，因为它解释了为什么 include 与继承一起使用时的行为。

然而，令我有些惊讶的是，没有人提到 Django 模板系统提供的 ssi 标签，该标签是专门为 内联 设计的，包括外部的文本嗯>。这里，内联意味着外部文本不会被解释、解析或插入，而只是在调用模板内“复制”。

请参阅文档以获取更多详细信息（请务必在页面右下部分的选择器中检查相应的 Django 版本）。

https://docs.djangoproject.com/en/dev/ref /templates/builtins/#ssi

来自文档：

<前><代码>ssi
将给定文件的内容输出到页面中。
与简单的 include 标记一样，{% ssi %} 包含另一个文件的内容
– 必须使用绝对路径指定 – 在当前页面中

还要注意此技术的安全隐患以及所需的 ALLOWED_INCLUDE_ROOTS 定义，必须将其添加到您的设置文件中。

Answer 8

您可以同时使用 {% extends %} 和 < a href="https://docs.djangoproject.com/en/4.2/ref/templates/builtins/#include" rel="nofollow noreferrer">{% include %} 在一个模板中。

例如，下面有base.html，显示Base：

# "templates/base.html"

<p>Base</p>

{% block content %}{% endblock %}

并且，下面有additional.html，显示Additional：

# "templates/additional.html"

<p>Additional</p>

并且，下面有 index.html，其中显示 Index：

# "templates/index.html"

<p>Index</p>

现在，您可以扩展 base.html 并包含 其他内容.html 位于 {% 块内%} 除了 index.html 中的

Index

如下所示，然后渲染 index.html 与 Django 视图：

# "templates/index.html"

{% extends "base.html" %}

{% block content %}
    <p>Index</p>
    {% include "additional.html" %}
{% endblock %}

然后，Base、Index 和 Additional 显示如下：

Base

Index

Additional

注意，{% block %} 下面和代码{% block %} 内部 base.html 中没有的内容在 index.html 中被忽略：

# "templates/index.html"

{% extends "base.html" %}

<p>Index</p>
{% include "additional.html" %}

{% block test %}
    <p>Index</p>
    {% include "additional.html" %}
{% endblock %}

因此，只有 Base显示如下：

Base