模板继承¶
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 %}
© 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() }}
。