模板继承

Jinja 最强大的功能之一就是模板继承。模板继承允许你构建一个包含网站所有通用元素的基础“骨架”模板, 并定义一些 块(blocks),供子模板覆盖。

听起来可能有些复杂,但其实非常基础。我们通过一个示例来理解会更加直观。

基础模板

下面这个模板,我们称之为 layout.html,它定义了一个简单的 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 %} 标签定义了四个可以由子模板填充的内容块。所有的 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 标签必须是模板中的第一个标签。如果你想在子模板中保留并显示父模板中 block 定义的内容,可以使用 {{ super() }}