use

Наследование шаблонов — одна из самых мощных функций Twig, но она ограничена единичным наследованием; шаблон может расширять только один другой шаблон. Это ограничение делает наследование шаблонов простым для понимания и удобным для отладки:

{% extends "base.html" %}

{% block title %}{% endblock %}
{% block content %}{% endblock %}

Горизонтальное повторное использование — это способ достижения той же цели, что и множественное наследование, но без связанной с ним сложности:

{% extends "base.html" %}

{% use "blocks.html" %}

{% block title %}{% endblock %}
{% block content %}{% endblock %}

Оператор use сообщает Twig, что нужно импортировать блоки, определенные в blocks.html, в текущий шаблон (это как макросы, но для блоков):

{# blocks.html #}

{% block sidebar %}{% endblock %}

В этом примере оператор use импортирует блок sidebar в основной шаблон. Код в основном эквивалентен следующему (импортированные блоки не выводятся автоматически):

{% extends "base.html" %}

{% block sidebar %}{% endblock %}
{% block title %}{% endblock %}
{% block content %}{% endblock %}

Основной шаблон также может переопределить любой импортированный блок. Если шаблон уже определяет блок sidebar, то определенный в blocks.html игнорируется. Чтобы избежать конфликтов имен, можно переименовать импортированные блоки:

{% extends "base.html" %}

{% use "blocks.html" with sidebar as base_sidebar, title as base_title %}

{% block sidebar %}{% endblock %}
{% block title %}{% endblock %}
{% block content %}{% endblock %}

Функция parent() автоматически определяет правильную иерархию наследования, поэтому она может использоваться при переопределении блока, определенного в импортированном шаблоне:

{% extends "base.html" %}

{% use "blocks.html" %}

{% block sidebar %}
{{ parent() }}
{% endblock %}

{% block title %}{% endblock %}
{% block content %}{% endblock %}

В этом примере parent() правильно вызовет блок sidebar из шаблона blocks.html.

{% extends "base.html" %}

{% use "blocks.html" with sidebar as parent_sidebar %}

{% block sidebar %}
{{ block('parent_sidebar') }}
{% endblock %}