模板继承 — Flask 文档

来自菜鸟教程
Flask/docs/1.1.x/patterns/templateinheritance
跳转至:导航、​搜索

模板继承

Jinja 最强大的部分是模板继承。 模板继承允许您构建一个基本的“骨架”模板,其中包含站点的所有公共元素并定义子模板可以覆盖的

听起来很复杂,但非常基本。 从一个例子开始最容易理解它。

基本模板

我们将这个模板称为 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 标签必须是模板中的第一个标签。 要渲染父模板中定义的块的内容,请使用 模板:Super()