twig => テンプレートの継承

基本テンプレートの使用

base.twig.html

<!DOCTYPE html>
<html>
    <head>
        <title>{{ title | default('Hello World') }}</title>
        <link rel="stylesheet" type="text/css" href="theme.css">
        {% block css %}
        {% endblock %}
    </head>
    <body>
    {% block body %}
        <nav>
        {% block navigation %}
            <a href="#">Link</a>
            <a href="#">Link</a>
            <a href="#">Link</a>
        {% endblock navigation %}
        </nav>
        <section id="container">
            <section id="content">
            {% block content %}
            <p>
            Lorem ipsum dolor sit amet.
            </p>
        </section>
        {% endblock content %}
    </section>
    {% endblock body %}
    </body>
</html>

page.twig.html

{% extends base.twig.html %}
{% block navigation %}
<a href="page2.html">Page 2</a>
<a href="page3.html">Page 3</a>
<a href="page4.html">Page 4</a>
{% endblock %}
{% block content %}
This is my first page
{% endblock content %}

含まれているテンプレートの内容を変更する

article.twig.html

<article>
    <h1>{{ article.title }}</h1>
    {% block content %}
    <p>{{ article.content }}</p>
    {% endblock %}
</article>

articles.twig.html

{# use default template for article #}
{% for article in articles %}
    {% include "article.twig.html" %}
{% endfor %}

{# use custom template for article #}
{% for article in articles %}
    {% embed "article.twig.html" %}
        {% block content %}
            <img src="{{ article.image }}" alt="{{ article.title }}" />
            {{ parent() }}
        {% endblock %}
    {% endembed %}
{% endfor %}

変数の継承

parent.html.twig

<!DOCTYPE html>
<html>
    <head>
        <title>{{ title_variable | default('Normal Page') }}</title>
    </head>
    <body>
         <h1>This is the {{ title_variable }} Page</h1>    
    </body>
</html>

child.html.twig

{% extends "parent.html.twig" %}
{% set title_variable = "Child" %}

インクルード、拡張、使用、マクロ、埋め込みの比較

Twigにはさまざまな種類の継承とコードの再利用があります：

含める

主な目的はコードの再利用です。使用を検討してheader.html.twig ＆ footer.html.twig内部base.html.twig例として。

header.html.twig

<nav>
   <div>Homepage</div>
   <div>About</div>
</nav>

base.html.twig

{% include 'header.html.twig' %}
<main>{% block main %}{% endblock %}</main>

拡張する

主な目的は垂直継承です。 homepage.html.twigとabout.html.twigを例としてbase.html.twigを拡張することを検討してください。

base.html.twig

{% include 'header.html.twig' %}
<main>{% block main %}{% endblock %}</main>

homepage.html.twig

{% extends 'base.html.twig' %}

{% block main %}
<p>You are at the homepage</p>
{% endblock %}

about.html.twig

{% extends 'base.html.twig' %}

{% block main %}
<p>You are at the about page</p>
{% endblock %}

つかいます

主な目標は、 水平方向の再利用です。使用を検討してsidebar.product.html.twig内側single.product.html.twig （拡張product.layout.html.twig ）とsingle.service.html.twigページ（ 'service.layout.html.page'を拡張）。（それはマクロのようですが、ブロックのためです）

sidebar.html.twig

<aside>{% block sidebar %}{% endblock %}</aside>

single.product.html.twig

{% extends 'product.layout.html.twig' %}

{% use 'sidebar.html.twig' %}
{% block main %}
<p>You are at the product page for product number 123</p>
{% endblock %}

single.service.html.twig

{% extends 'service.layout.html.twig' %}

{% use 'sidebar.html.twig' %}
{% block main %}
<p>You are at the service page for service number 456</p>
{% endblock %}

マクロ

主な目標は、変数を使用して多くのテンプレートにわたって再利用可能なマークアップを作成することです 。いくつかの変数を取得し、マークアップを出力する関数を考えてみましょう。

form.html.twig

％name = "{{name}}" value = "{{value | e}}" {input} "}}" /> {％endmacro％}

profile.service.html.twig

{% import "forms.html.twig" as forms %}

<div>{{ forms.input('username') }}</div>

埋め込み

主な目標はブロックの上書きです。これは、両方の機能をUseと一緒にInclude 。 product.table.html.twig ＆ service.table.html.twig pagination.html.twigを埋め込むことを検討してください。

pagination.html.twig

<div>
    <div>{% block first %}{% endblock %}</div>
    {% for i in (min + 1)..(max - 1) %}
        <div>{{ i }}</div>
    {% endfor %}
    <div>{% block last %}{% endblock %}</div>
</div>

product.table.html.twig

{% set min, max = 1, products.itemPerPage %}

{% embed 'pagination.html.twig' %}
    {% block first %}First Product Page{% endblock %}
    {% block last %}Last Product Page{% endblock %}
{% endembed %}

service.table.html.twig

{% set min, max = 1, services.itemPerPage %}

{% embed 'pagination.html.twig' %}
    {% block first %}First Service Page{% endblock %}
    {% block last %}Last Service Page{% endblock %}
{% endembed %}

埋め込みファイル（ここではpagination.html.twig ）は現在のコンテキスト（ここではmin 、 max変数）にアクセスできることに注意してください。また、埋め込みファイルに余分な変数を渡すこともできます：