模板继承¶

Jinja 最有力的部分就是模板继承。模板继承允许你创建一个基础“骨架”模板。这个模板中包含站点的常用元素，定义可以被子模板继承的 块 。

听起来很复杂其实做起来简单，看看下面的例子就容易理解了。

基础模板¶

这个模板的名称是 :file:layout.html ，它定义了一个简单的 HTML 骨架，用于显示一个简单的两栏页面。“子”模板的任务是用内容填充空的块：

  1. <!doctype html>
  2. <html>
  3.   <head>
  4.     {% block head %}
  5.     <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
  6.     <title>{% block title %}{% endblock %} - My Webpage</title>
  7.     {% endblock %}
  8.   </head>
  9.   <body>
  10.     <div id="content">{% block content %}{% endblock %}</div>
  11.     <div id="footer">
  12.       {% block footer %}
  13.       &copy; Copyright 2010 by <a href="http://domain.invalid/">you</a>.
  14.       {% endblock %}
  15.     </div>
  16.   </body>
  17. </html>

在这个例子中， {% block %} 标记定义了四个可以被子模板填充的块。 block标记告诉模板引擎这是一个可以被子模板重载的部分。

子模板¶

子模板示例：

  1. {% extends "layout.html" %}
  2. {% block title %}Index{% endblock %}
  3. {% block head %}
  4.   {{ super() }}
  5.   <style type="text/css">
  6.     .important { color: #336699; }
  7.   </style>
  8. {% endblock %}
  9. {% block content %}
  10.   <h1>Index</h1>
  11.   <p class="important">
  12.     Welcome on my awesome homepage.
  13. {% endblock %}

这里 {% extends %} 标记是关键，它告诉模板引擎这个模板“扩展”了另一个模板，当模板系统评估这个模板时会先找到父模板。这个扩展标记必须是模板中的第一个标记。如果要使用父模板中的块内容，请使用 {{ super() }} 。

原文: https://dormousehole.readthedocs.io/en/latest/patterns/templateinheritance.html