Jinja 最为强大的地方在于他的模板继承功能,模板继承允许你创建一个基础的骨架模板, 这个模板包含您网站的通用元素,并且定义子模板可以重载的 blocks 。
听起来虽然复杂,但是其实非常初级。理解概念的最好方法就是通过例子。
基础模板
在这个叫做 layout.html 的模板中定义了一个简单的 HTML 文档骨架,你可以将这个骨架用作一个简单的双栏页面。而子模板负责填充空白的 block:
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 © Copyright 2010 by <a href="http://domain.invalid/">you</a>. 14 {% endblock %} 15 </div> 16 </body>
在这个例子中,使用 {% 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 %} 是这个例子的关键,它会告诉模板引擎这个模板继承自另一个模板的, 模板引擎分析这个模板时首先会定位其父父模板。extends 标签必须是模板的首个标签。 想要渲染父模板中的模板需要使用 {{ super() }}。