jinja2是Flask作者開(kāi)發(fā)的一個(gè)模板系統(tǒng)，起初是仿django模板的一個(gè)模板引擎，為Flask提供模板支持，由于其靈活，快速和安全等優(yōu)點(diǎn)被廣泛使用。
jinja2的優(yōu)點(diǎn)
jinja2之所以被廣泛使用是因?yàn)樗哂幸韵聝?yōu)點(diǎn)：
- 相對(duì)于Template，jinja2更加靈活，它提供了控制結(jié)構(gòu)，表達(dá)式和繼承等。
- 相對(duì)于Mako，jinja2僅有控制結(jié)構(gòu)，不允許在模板中編寫(xiě)太多的業(yè)務(wù)邏輯。
- 相對(duì)于Django模板，jinja2性能更好。
- Jinja2模板的可讀性很棒。
jinja2語(yǔ)法
作為一個(gè)模板系統(tǒng)，它還提供了特殊的語(yǔ)法，我們按照它支持的語(yǔ)法進(jìn)行編寫(xiě)之后，就能使用jinja2模塊進(jìn)行渲染。
基本語(yǔ)法
在jinja2中，存在三種語(yǔ)法：
1.控制結(jié)構(gòu) {% %}
2.變量取值 {{ }}
3.注釋 {# #}
下面是一個(gè)簡(jiǎn)單的jinja2例子
{# This is jinja code
{% for file in filenames %}
...
{% endfor %}
#}
可以看到，for循環(huán)的使用方式和Python比較類(lèi)似，但是沒(méi)有了句尾的冒號(hào)，另外需要使用endfor最為結(jié)尾，其實(shí)在jinja2中，if也是一樣的，結(jié)尾需要使用endif。
jinja2變量
jinja2模板中使用 {{ }} 語(yǔ)法表示一個(gè)變量，它是一種特殊的占位符。當(dāng)利用jinja2進(jìn)行渲染的時(shí)候，它會(huì)把這些特殊的占位符進(jìn)行填充/替換，jinja2支持python中所有的Python數(shù)據(jù)類(lèi)型比如列表、字段、對(duì)象等。
<p>this is a dicectory:{{ mydict['key'] }} </p>
<p>this is a list:{{ mylist[3] }} </p>
<p>this is a object:{{ myobject.something() }} </p>
jinja2中的過(guò)濾器
變量可以通過(guò)“過(guò)濾器”進(jìn)行修改，過(guò)濾器可以理解為是jinja2里面的內(nèi)置函數(shù)和字符串處理函數(shù)。
常用的過(guò)濾器有：
| 過(guò)濾器名稱(chēng) | 說(shuō)明 |
|---|---|
| safe | 渲染時(shí)值不轉(zhuǎn)義 |
| capitialize | 把值的首字母轉(zhuǎn)換成大寫(xiě) |
| lower | 把值轉(zhuǎn)換成小寫(xiě)形式 |
| upper | 把值轉(zhuǎn)換成大寫(xiě)形式 |
| title | 把值中每個(gè)單詞的首字母都轉(zhuǎn)換成大寫(xiě) |
| trim | 把值的首尾空格去掉 |
| striptags | 渲染之前把值中所有的HTML標(biāo)簽都刪掉 |
| join | 拼接多個(gè)值為字符串 |
| replace | 替換字符串的值 |
| round | 默認(rèn)對(duì)數(shù)字進(jìn)行四舍五入，也可以用參數(shù)進(jìn)行控制 |
| int | 把值轉(zhuǎn)換成整型 |
| 那么如何使用這些過(guò)濾器呢？ 只需要在變量后面使用管道( | )分割，多個(gè)過(guò)濾器可以鏈?zhǔn)秸{(diào)用，前一個(gè)過(guò)濾器的輸出會(huì)作為后一個(gè)過(guò)濾器的輸入。 |
{{ 'abc' | captialize }}
# Abc
{{ 'abc' | upper }}
# ABC
{{ 'hello world' | title }}
# Hello World
{{ "hello world" | replace('world','daxin') | upper }}
# HELLO DAXIN
{{ 18.18 | round | int }}
# 18
jinja2的控制結(jié)構(gòu)
jinja2中的if語(yǔ)句類(lèi)似與Python的if語(yǔ)句，它也具有單分支，多分支等多種結(jié)構(gòu)，不同的是，條件語(yǔ)句不需要使用冒號(hào)結(jié)尾，而結(jié)束控制語(yǔ)句，需要使用endif關(guān)鍵字。
{% if daxin.safe %}
daxin is safe.
{% elif daxin.dead %}
daxin is dead
{% else %}
daxin is okay
{% endif %}
jinja2的for循環(huán)
jinja2中的for循環(huán)用于迭代Python的數(shù)據(jù)類(lèi)型，包括列表，元組和字典。在jinja2中不存在while循環(huán)。
迭代列表
<ul>
{% for user in users %}
<li>{{ user.username|title }}</li>
{% endfor %}
</ul>
迭代字典
<dl>
{% for key, value in my_dict.iteritems() %}
<dt>{{ key }}</dt>
<dd>{{ value}}</dd>
{% endfor %}
</dl>
當(dāng)然也可以加入else語(yǔ)句，在循環(huán)正確執(zhí)行完畢后，執(zhí)行
在for循環(huán)中，jinja2還提供了一些特殊的變量，用以來(lái)獲取當(dāng)前的遍歷狀態(tài)：
變量 描述
loop.index 當(dāng)前迭代的索引（從1開(kāi)始）
loop.index0 當(dāng)前迭代的索引（從0開(kāi)始）
loop.first 是否是第一次迭代，返回bool
loop.last 是否是最后一次迭代，返回bool
loop.length 序列中的項(xiàng)目數(shù)量
loop.revindex 到循環(huán)結(jié)束的次數(shù)（從1開(kāi)始）
loop.revindex0 到循環(huán)結(jié)束的次數(shù)(從0開(kāi)始）
jinja2的宏
宏類(lèi)似于Python中的函數(shù)，我們?cè)诤曛卸x行為，還可以進(jìn)行傳遞參數(shù)，就像Python中的函數(shù)一樣一樣兒的。
在宏中定義一個(gè)宏的關(guān)鍵字是macro，后面跟其 宏的名稱(chēng)和參數(shù)等
{% macro input(name,age=18) %} # 參數(shù)age的默認(rèn)值為18
<input type='text' name="{{ name }}" value="{{ age }}" >
{% endmacro %}
調(diào)用方法也和Python的類(lèi)似
<p>{{ input('daxin') }} </p>
<p>{{ input('daxin',age=20) }} </p>
jinja2的繼承和Super函數(shù)
jinja2中最強(qiáng)大的部分就是模板繼承。模板繼承允許我們創(chuàng)建一個(gè)基本(骨架)文件，其他文件從該骨架文件繼承，然后針對(duì)自己需要的地方進(jìn)行修改。
jinja2的骨架文件中，利用block關(guān)鍵字表示其包涵的內(nèi)容可以進(jìn)行修改。
以下面的骨架文件base.html為例：
<!DOCTYPE html>
<html lang="en">
<head>
{% block head %}
<link rel="stylesheet" href="style.css"/>
<title>{% block title %}{% endblock %} - My Webpage</title>
{% endblock %}
</head>
<body>
<div id="content">{% block content %}{% endblock %}</div>
<div id="footer">
{% block footer %}
<script>This is javascript code </script>
{% endblock %}
</div>
</body>
</html>
這里定義了四處 block，即：head，title，content，footer。那怎么進(jìn)行繼承和變量替換呢？注意看下面的文件
{% extend "base.html" %} # 繼承base.html文件
{% block title %} Dachenzi {% endblock %} # 定制title部分的內(nèi)容
{% block head %}
{{ super() }} # 用于獲取原有的信息
<style type='text/css'>
.important { color: #FFFFFF }
</style>
{% endblock %}
# 其他不修改的原封不同的繼承
PS: super()函數(shù) 表示獲取block塊中定義的原來(lái)的內(nèi)容。
利用jinja2進(jìn)行渲染
jinja2模塊中有一個(gè)名為Enviroment的類(lèi)，這個(gè)類(lèi)的實(shí)例用于存儲(chǔ)配置和全局對(duì)象，然后從文件系統(tǒng)或其他位置中加載模板。
基本使用方法
大多數(shù)應(yīng)用都在初始化的時(shí)候撞見(jiàn)一個(gè)Environment對(duì)象，并用它加載模板。Environment支持兩種加載方式：
- PackageLoader：包加載器
- FileSystemLoader：文件系統(tǒng)加載器
PackageLoader
使用包加載器來(lái)加載文檔的最簡(jiǎn)單的方式如下：
from jinja2 import PackageLoader,Environment
env = Environment(loader=PackageLoader('python_project','templates')) #創(chuàng)建一個(gè)包加載器對(duì)象
template = env.get_template('bast.html') # 獲取一個(gè)模板文件
template.render(name='daxin',age=18) # 渲染
其中：
- PackageLoader()的兩個(gè)參數(shù)為：python包的名稱(chēng)，以及模板目錄名稱(chēng)。
- get_template()：獲取模板目錄下的某個(gè)具體文件。
- render()：接受變量，對(duì)模板進(jìn)行渲染
FileSystemLoader
文件系統(tǒng)加載器，不需要模板文件存在某個(gè)Python包下，可以直接訪(fǎng)問(wèn)系統(tǒng)中的文件。
