模板继承¶
Jinja最强大的部分是模板继承。 Jinja 最为强大的地方在于他的模板继承功能,模板继承允许你创建一个基础的骨架模板, 这个模板包含您网站的通用元素,并且定义子模板可以重载的 blocks 。
听起来虽然复杂,但是其实非常初级。 从一个例子开始,最容易理解它。
基本模板¶
此模板(我们称为layout.html
)定义了一个简单的HTML骨架文档,您可以将其用于简单的两列页面。 而子模板负责填充空白的 block:
<!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>
在这个例子中,使用 {% templatetag openblock %} block {% templatetag closeblock %}
标签定义了四个子模板可以重载的块。 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 标签必须是模板的首个标签。 要渲染父模板中定义的块的内容,请使用{{ super() }}
。