menu-btn

{% partial %}

October CMS Documentation Docs
/

{% partial %}

{% partial %} 标签将解析 CMS部件 并在页面上呈现部件内容。要显示一个名为 footer.htm 的部件，只需在 partial 标记后传递名称作为字符串引用。

{% partial "footer" %}

子目录中的部件可以以相同的方式呈现。

{% partial "sidebar/menu" %}

注意: 主题文档 有更多关于子目录使用的详细信息。

部件名称也可以是变量：

{% set tabName = "profile" %}
{% partial tabName %}

# 变量

在部件内部，变量可以像任何其他标记变量一样被访问：

{% partial "blog-posts" posts=posts %}

您还可以分配新变量以在部件中使用：

{% partial "location" city="温哥华" country="加拿大" %}

在部件内部，变量可以像任何其他标记变量一样被访问：

<p>Country: {{ country }}, city: {{ city }}.</p>

# 将标记作为变量传递

可以使用 body 属性将标记传递给部件。

{% partial "card" body %}
    这是卡片内容
{% endpartial %}

然后内容可作为 body 变量使用。

{{ body|raw }}

# 将部件内容设置为 Twig 变量

在任何模板中，您都可以使用 partial() 函数将部件内容设置为变量。 这使您可以在显示之前操作输出。 请记住使用 |raw 过滤器来防止输出转义。

{% set cardPartial = partial('my-cards/card') %}

{{ cardPartial|raw }}

您也可以将变量作为第二个参数传递给部分。

{% set cardPartial = partial('my-cards/card', { foo: 'bar' }) %}

# 检查部件是否存在

hasPartial() 函数可用于在不渲染内容的情况下检查部件是否存在，如果找到部分，它将返回 true 或 false。

{% if hasPartial('my-cards/card') %}
    {% partial 'my-cards/card' %}
{% else %}
    <p>未找到卡片</p>
{% endif %}

← {% content %} →