如何将选定的命名参数传递给 Jinja2 的包含上下文？

Question

使用 Django 模板引擎，我可以在使用命名参数设置自定义上下文时包含另一个部分模板，如下所示：

{% include "list.html" with articles=articles_list1 only %}
{% include "list.html" with articles=articles_list2 only %}

正如您可能假设的，articles_list1 和 articles_list2 是两个不同的列表，但我可以重用相同的 list.html 模板，该模板将使用 articles 变量。

我正在尝试使用 Jinja2 实现相同的目标，但我看不到推荐的方法，因为不支持 with 关键字。

Answer 1

Jinja2 有 with 关键字 - 它不会'它不会为您提供与 Django 相同的语法，它可能不会按照您预期的方式工作，但您可以这样做：

{% with articles=articles_list1 %}
    {% include "list.html" %}
{% endwith %}
{% with articles=articles_list2 %}
    {% include "list.html" %}
{% endwith %}

但是，如果 list.html 基本上只是作为创建列表的一种方式，那么您可能想将其更改为 宏 相反 - 这将为您提供更大的灵活性。

{% macro build_list(articles) %}
    <ul>
        {% for art in articles %}
            <li>{{art}}</li>
        {% endfor %}
    </ul>
{% endmacro %}

{# And you call it thusly #}
{{ build_list(articles_list1) }}
{{ build_list(articles_list2) }}

要从另一个模板使用此宏，请导入它：

{% from "build_list_macro_def.html" import build_list %}

Answer 2

这样你就可以将多个变量传递给Jinja2 Include语句 - （通过在With语句中用逗号分隔变量）：

            {% with var_1=123, var_2="value 2", var_3=500 %}
                {% include "your_template.html" %}
            {% endwith %}

Answer 3

对于 2017 年以上的读者，自 2.9 开始，Jinja 默认包含 with 语句。无需延期。

http://jinja.pocoo.org/docs/2.9/templates/#with -声明

在旧版本的 Jinja（2.9 之前）中，需要通过扩展来启用此功能。现在默认启用它。

Answer 4

更新2021+

默认情况下，包含的模板可以访问活动上下文的变量。有关导入和包含的上下文行为的更多详细信息，请参阅导入上下文行为< /a>.

从 Jinja 2.2 开始，您可以使用忽略缺失来标记包含；在这种情况下，如果要包含的模板不存在，Jinja 将忽略该语句。当与 with 或 without context 结合使用时，它必须放置在上下文可见性语句之前。以下是一些有效的示例：

{% include "sidebar.html" ignore missing %}
{% include "sidebar.html" ignore missing with context %}
{% include "sidebar.html" ignore missing without context %}

Answer 5

另一种无需插件的选择是使用宏并将其包含在另一个文件中：

文件 ma​​cro.j2

{% macro my_macro(param) %}
  {{ param }}
{% endmacro %}

文件 ma​​in.j2< /em>

{% from 'macro.j2' import my_macro %}

{{ my_macro(param) }}