テンプレートの継承—フラスコのドキュメント

提供:Dev Guides
< FlaskFlask/docs/1.0.x/patterns/templateinheritance
移動先:案内検索

テンプレートの継承

Jinjaの最も強力な部分は、テンプレートの継承です。 テンプレートの継承により、サイトのすべての一般的な要素を含み、子テンプレートがオーバーライドできるブロックを定義する基本の「スケルトン」テンプレートを構築できます。

複雑に聞こえますが、非常に基本的です。 例から始めることでそれを理解するのが最も簡単です。

基本テンプレート

このテンプレート(layout.htmlと呼びます)は、単純な2列のページに使用できる単純なHTMLスケルトンドキュメントを定義します。 空のブロックをコンテンツで埋めるのは「子」テンプレートの仕事です。

<!doctype html>
<html>
  <head>
    {% block head %}
    <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
    <title>{% block title %}{% endblock %} - My Webpage</title>
    {% endblock %}
  </head>
  <body>
    <div id="content">{% block content %}{% endblock %}</div>
    <div id="footer">
      {% block footer %}
      &copy; Copyright 2010 by <a href="http://domain.invalid/">you</a>.
      {% endblock %}
    </div>
  </body>
</html>

この例では、{% block %}タグは、子テンプレートが入力できる4つのブロックを定義します。 block タグが行うのは、子テンプレートがテンプレートのそれらの部分をオーバーライドする可能性があることをテンプレートエンジンに通知することだけです。


子テンプレート

子テンプレートは次のようになります。

{% extends "layout.html" %}
{% block title %}Index{% endblock %}
{% block head %}
  {{ super() }}
  <style type="text/css">
    .important { color: #336699; }
  </style>
{% endblock %}
{% block content %}
  <h1>Index</h1>
  <p class="important">
    Welcome on my awesome homepage.
{% endblock %}

ここで重要なのは{% extends %}タグです。 これは、このテンプレートが別のテンプレートを「拡張」することをテンプレートエンジンに通知します。 テンプレートシステムがこのテンプレートを評価するとき、最初に親を見つけます。 extendsタグは、テンプレートの最初のタグである必要があります。 親テンプレートで定義されたブロックのコンテンツをレンダリングするには、テンプレート:Super()を使用します。