Twig: 포함, 포함 및 매크로 – 언제 재사용할 것인가?

이것은 제 프론트엔드 직원들이 제게 자주 묻는 질문입니다. 솔직히 말해서, 저는 모든 상황에 맞는 좋은 대답을 가지고 있지 않습니다. 불행히도 문서도 도움이되지 않습니다.

따라서 다음 코드 블록은 대략 동일한 작업을 수행합니다.

포함하다

# someFile.html.twig
{% set foo = "Foo!" %}
{% set bar %} {# <-- omit this assignment if you want the default #}
   even more bar
{% endset %}
{% include "reused.html.twig" %}

# reused.html.twig
<h1>{{ foo }} </h1>
<p>Some common stuff.</p>
{% if bar %}
    {{ bar | raw }} 
{% else %}
    <p>Default text for bar.</p>
{% endif %}

포함시키다

# someFile.html.twig
{% embed "reused.html.twig" %}
    {% block foo %} Foo! {% endblock %}
    {% block bar %} {# <-- again, this may be omitted #}
       even more bar
    {% endblock %}
{% endembed %}

# reused.html.twig
<h1>{% block foo %}{% endblock %} </h1>
<p>Some common stuff.</p>
{% block bar %}
    <p>Default text for bar.</p>
{% endblock %}

매크로

# someFile.html.twig
{% import "reused.html.twig" as macros %}
{% set bar %} {# <-- omit this assignment if you want the default #}
   even more bar
{% endset %}
{{ macros.someBlock("Foo!", bar) }}

# reused.html.twig
{% macro someBlock(foo, bar) %}
<h1>{{ foo }} </h1>
<p>Some common stuff.</p>
{% if bar %}
    {{ bar | raw }} 
{% else %}
    <p>Default text for bar.</p>
{% endif %}
{% endmacro %}

가독성, 간결성 또는 명시적 인터페이스(매크로 서명)를 갖는 이점 및 캡슐화/범위 지정 변수의 이점을 포함하여 이러한 모든 접근 방식에는 많은 장단점이 있습니다.

권장 사항이 있거나 어느 것을 언제 사용해야 하는지에 대한 좋은 경험 법칙이 있습니까?

말할 필요도 없이 여기서 좋은 결과를 얻으면 문서 PR을 작성하게 되어 기쁩니다 :-).