armstrong.core.arm_layout 1.4.0

速查表

{% load layout_helpers %}

{% render_model model_obj "template_name" %}

<!-- otherwise render_model behaves exactly like {% include ... %} -->
{% render_model model_obj "template_name" with additional="data" %}
{% render_model model_obj "template_name" with isolated="context" only %}

<!-- shortcut to call render_model on a list of model objects -->
{% render_list list_of_models "template_name" %}

<!-- or more flexible looping -->
{% render_iter list_of_models %}
    {% render_next "big" %}
    {% render_next "small" %}
    {% render_next "big" %}
    {% render_remainder "small" %}
{% endrender_iter %}

深入

要加载模板标签，请添加以下行（通常在模板顶部）：

{% load layout_helpers %}

现在您可以使用 render_model 模板标签以这种方式显示给定的模型：

{% render_model some_model "full_page" %}

some_model 是模板中的一个变量，它是一个模型实例，字符串 "full_page" 是您“布局”的名称。 render_model 会查找名为 layout/<app_label>/<model>/<layout>.html 的模板来确定用于显示模型实例的内容。更进一步，它足够智能，可以遍历模型的继承关系，以确定是否有可以使用的父模型布局。例如，如果 some_model 是 armstrong.apps.articles.models.Article 的实例，它继承自 armstrong.apps.content.models.Content，则 render_model 会按以下顺序查找以下模板

["layout/articles/article/full_page.html",
 "layout/content/content/full_page.html", ]

您可以在 full_page.html 模板中访问整个模板上下文。您还有一个名为 object 的新变量，它代表您提供给 render_model 的模型实例。该变量仅在布局模板中可用，并临时覆盖任何其他名为 object 的上下文变量。除了可以根据模型继承关系查找模板的灵活性之外，此标签的功能与 {% include %} 一样。您可以使用 with extra="param" 添加上下文，或使用 only 隔离上下文。一旦 render_model 完成，它将恢复原始上下文。

layout_helpers 提供了两个其他辅助方法，可以轻松渲染多个模型，而无需手动遍历它们。您可以使用相同的模板渲染整个模型列表

{% render_list list_of_models "preview" %}

或者使用更细粒度的块标签，允许您为每个模型实例指定模板，然后使用公共模板渲染其余部分

{% render_iter list_of_models %}
    {% render_next "preview" %}
    {% render_next "preview" %}
    {% render_next "preview" %}
    {% render_remainder "headline" %}
{% endrender_iter %}

当然，您也可以用另一种方式做到这一点

{% render_list list_of_models[:3] "preview" %}
{% render_list list_of_models[3:] "headline" %}

这些循环辅助工具的局限性是它们不能使用 with 或 only 添加或限制上下文，如 render_model 所做的那样。但是，您可以包裹这些标签在一个 {% with need="this" and="that" %} ... {% endwith %} 块中。请参阅 with 文档。