Jinja2模版引擎
示例：
templates/index.html:Jinja2 模板
<h1>Hello World!</h1>
示例:
templates/user.html:Jinja2 模板
<h1>Hello, {{ name }}!</h1>
渲染模版
例如：hello.py:渲染模板
from flask import Flask, render_template
# ...
@app.route('/')
def index():
return render_template('index.html')
@app.route('/user/<name>')
def user(name):
return render_template('user.html', name=name)
Flask 提供的 render_template 函數把 Jinja2 模板引擎集成到了程序中。render_template 函數的第一個參數是模板的文件名。隨后的參數都是鍵值對,表示模板中變量對應的真實值。在這段代碼中,第二個模板收到一個名為 name 的變量。左邊的“name”表示參數名,就是模板中使用的占位符;右邊的“name”是當前作用域中的變量,表示同名參數的值
<p>A value from a dictionary: {{ mydict['key'] }}.</p>
<p>A value from a list: {{ mylist[3] }}.</p>
<p>A value from a list, with a variable index: {{ mylist[myintvar] }}.</p>
<p>A value from an object's method: {{ myobj.somemethod() }}.</p>
可以使用過濾器修改變量,過濾器名添加在變量名之后,中間使用豎線分隔。例如,下述模板以首字母大寫形式顯示變量 name 的值:
Hello, {{ name|capitalize }}
Jinja2變量過濾器
控制結構
下面這個例子展示了如何在模板中使用條件控制語句:
{% if user %}
Hello, {{ user }}!
{% else %}
Hello, Stranger!
{% endif %}
另一種常見需求是在模板中渲染一組元素。下例展示了如何使用 for 循環實現這一需求:
<ul>
{% for comment in comments %}
<li>{{ comment }}</li>
{% endfor %}
</ul>
Jinja2 還支持宏。宏類似于 Python 代碼中的函數。例如:
{% macro render_comment(comment) %}
<li>{{ comment }}</li>
{% endmacro %}
<ul>
{% for comment in comments %}
{{ render_comment(comment) }}
{% endfor %}
</ul>
為了重復使用宏,我們可以將其保存在單獨的文件中,然后在需要使用的模板中導入:
{% import 'macros.html' as macros %}<ul>
{% for comment in comments %}
{{ macros.render_comment(comment) }}
{% endfor %}
</ul>
需要在多處重復使用的模板代碼片段可以寫入單獨的文件,再包含在所有模板中,以避免重復:
{% include 'common.html' %}
另一種重復使用代碼的強大方式是模板繼承,它類似于 Python 代碼中的類繼承。首先,創
建一個名為 base.html 的基模板:
<html>
<head>
{% block head %}
<title>{% block title %}{% endblock %} - My Application</title>
{% endblock %}
</head>
<body>
{% block body %}
{% endblock %}
</body>
</html>
block 標簽定義的元素可在衍生模板中修改。在本例中,我們定義了名為 head、title 和
body 的塊。注意,title 包含在 head 中。下面這個示例是基模板的衍生模板:
{% extends "base.html" %}
{% block title %}Index{% endblock %}
{% block head %}
{{ super() }}
<style>
</style>
{% endblock %}
{% block body %}
<h1>Hello, World!</h1>
{% endblock %}
extends 指令聲明這個模板衍生自 base.html。在 extends 指令之后,基模板中的 3 個塊被重新定義,模板引擎會將其插入適當的位置。注意新定義的 head 塊,在基模板中其內容不是空的,所以使用 super() 獲取原來的內容。
Flask-Bootstrap
如果程序需要向已經有內容的塊中添加新內容,必須使用 Jinja2 提供的 super() 函數。例如,如果要在衍生模板中添加新的 JavaScript 文件,需要這么定義 scripts 塊:
{% block scripts %}
{{ super() }}
<script type="text/javascript" src="my-script.js"></script>
{% endblock %}
