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 %}