Menu
Jinja Include: multiple template reuse and inclusion – Jinja Documentation

Jinja Include: 複数のテンプレートの再利用と組み込み

Jinja: 複数のテンプレートの再利用と組み込み

include タグは 1 つのテンプレートに限定されません。 テンプレートのリストを指定すると、Jinja2 は存在するテンプレートが見つかるまで、それぞれを順番にレンダリングしようとします。これは、フォールバックを作成したり、ページの詳細バージョンが存在する場合はそれをレンダリングし、存在しない場合は一般的なバージョンにフォールバックするなど、特定のケースを処理する場合に非常に便利な機能です。

仕組み

テンプレート パスのリストを指定すると、Jinja2 はリストを左から右に反復処理します。見つかって欠落していない最初のテンプレートがレンダリングされ、現在のテンプレートに挿入されます。リスト内の後続のテンプレートはすべて無視されます。これにより、テンプレート インクルードの優先リストを設定できます。

コードのデモ

複数のテンプレートを含める方法の例をいくつか見てみましょう。まず、単純なフォールバックを使用した基本的な使用法です。

フォールバックを使用した基本的な使用法

text
{% include ['page_detailed.html', 'page.html'] %}

この例では、page_detailed.html が存在する場合、それが表示されます。そうでない場合、Jinja2 は page.html のレンダリングに戻ります。

欠落を無視して組み合わせる

これをignore missing キーワードと組み合わせて、リストにテンプレートが存在しない状況を適切に処理することもできます。これにより、ページ全体がクラッシュするのを防ぎます。

text
{% include ['special_sidebar.html', 'sidebar.html'] ignore missing %}

ここで、エンジンは最初に special_sidebar.html を検索します。存在しない場合は、sidebar.html を探します。どちらも見つからない場合、ステートメントは無視され、エラーは発生しません。

変数の使用

テンプレート名を保持する変数や、テンプレート属性を持つオブジェクトをステートメントに渡すこともできます。

text
{% set my_template_list = ['user_info.html', 'default_info.html'] %}
{% include my_template_list %}

これにより最大限の柔軟性が得られ、アプリケーションのロジックに基づいてどのテンプレートを含めるかを動的に決定できるようになります。