Jinja Include: 複数のテンプレートの再利用と組み込み
Jinja: 複数のテンプレートの再利用と組み込み
include タグは 1 つのテンプレートに限定されません。 テンプレートのリストを指定すると、Jinja2 は存在するテンプレートが見つかるまで、それぞれを順番にレンダリングしようとします。これは、フォールバックを作成したり、ページの詳細バージョンが存在する場合はそれをレンダリングし、存在しない場合は一般的なバージョンにフォールバックするなど、特定のケースを処理する場合に非常に便利な機能です。
仕組み
テンプレート パスのリストを指定すると、Jinja2 はリストを左から右に反復処理します。見つかって欠落していない最初のテンプレートがレンダリングされ、現在のテンプレートに挿入されます。リスト内の後続のテンプレートはすべて無視されます。これにより、テンプレート インクルードの優先リストを設定できます。
コードのデモ
複数のテンプレートを含める方法の例をいくつか見てみましょう。まず、単純なフォールバックを使用した基本的な使用法です。
フォールバックを使用した基本的な使用法
{% include ['page_detailed.html', 'page.html'] %}この例では、page_detailed.html が存在する場合、それが表示されます。そうでない場合、Jinja2 は page.html のレンダリングに戻ります。
欠落を無視して組み合わせる
これをignore missing キーワードと組み合わせて、リストにテンプレートが存在しない状況を適切に処理することもできます。これにより、ページ全体がクラッシュするのを防ぎます。
{% include ['special_sidebar.html', 'sidebar.html'] ignore missing %}ここで、エンジンは最初に special_sidebar.html を検索します。存在しない場合は、sidebar.html を探します。どちらも見つからない場合、ステートメントは無視され、エラーは発生しません。
変数の使用
テンプレート名を保持する変数や、テンプレート属性を持つオブジェクトをステートメントに渡すこともできます。
{% set my_template_list = ['user_info.html', 'default_info.html'] %}
{% include my_template_list %}これにより最大限の柔軟性が得られ、アプリケーションのロジックに基づいてどのテンプレートを含めるかを動的に決定できるようになります。
ジャンプ