include

Оператор include включает шаблон и выводит отрендеренное содержимое этого файла:

{% include 'header.html' %}
    Body
{% include 'footer.html' %}

Примечание

Начиная с Twig 1.12, рекомендуется использовать функцию include, так как она предоставляет те же возможности с немного большей гибкостью:

Функция include семантически более «правильная» (включение шаблона выводит его отрендеренное содержимое в текущем контексте; тег не должен отображать ничего);

Функция include более «компонована»:

{# Store a rendered template in a variable #}
{% set content %}
{% include 'template.html' %}
{% endset %}
{# vs #}
{% set content = include('template.html') %}

{# Apply filter on a rendered template #}
{% apply upper %}
{% include 'template.html' %}
{% endapply %}
{# vs #}
{{ include('template.html')|upper }}

Функция include не накладывает никаких особых ограничений на порядок аргументов благодаря именованным аргументам.

Включенные шаблоны имеют доступ к переменным активного контекста.

Если вы используете загрузчик файлов, шаблоны ищутся в путях, определённых им.

Вы можете добавить дополнительные переменные, передав их после ключевого слова %%%CODE_BLOCK_6%%:

{# template.html will have access to the variables from the current context and the additional ones provided #}
{% include 'template.html' with {'foo': 'bar'} %}

{% set vars = {'foo': 'bar'} %}
{% include 'template.html' with vars %}

Вы можете отключить доступ к контексту, добавив ключевое слово %%%CODE_BLOCK_8%%:

{# only the foo variable will be accessible #}
{% include 'template.html' with {'foo': 'bar'} only %}

{# no variables will be accessible #}
{% include 'template.html' only %}

Подсказка

При включении шаблона, созданного конечным пользователем, следует рассмотреть возможность его песочницы. Дополнительная информация в главе Twig для разработчиков и в документации тега sandbox.

Имя шаблона может быть любым допустимым выражением Twig:

{% include some_var %}
{% include ajax ? 'ajax.html' : 'not_ajax.html' %}

И если выражение оценивается как \Twig\Template или \Twig\TemplateWrapper экземпляр, Twig будет использовать его напрямую:

// {% include template %}

$template = $twig->load('some_template.twig');

$twig->display('template.twig', ['template' => $template]);

Вы можете пометить включение тегом %%%CODE_BLOCK_15%%, в этом случае Twig проигнорирует оператор, если включённый шаблон не существует. Он должен быть размещён сразу после имени шаблона. Вот несколько допустимых примеров:

{% include 'sidebar.html' ignore missing %}
{% include 'sidebar.html' ignore missing with {'foo': 'bar'} %}
{% include 'sidebar.html' ignore missing only %}

Вы также можете предоставить список шаблонов, которые проверяются на существование перед включением. Первый существующий шаблон будет включен:

{% include ['page_detailed.html', 'page.html'] %}

Если ignore missing задано, он вернётся к рендерингу ничего, если ни один из шаблонов не существует, в противном случае он выбросит исключение.

© 2009–2018 by the Twig Team
Licensed under the three clause BSD license.
The Twig logo is © 2010–2020 Symfony
https://twig.symfony.com/doc/2.x/tags/include.html