jinja2介紹
jinja2是Flask做者開發的一個模板系統,起初是仿django模板的一個模板引擎,爲Flask提供模板支持,因爲其靈活,快速和安全等優勢被普遍使用。javascript
jinja2的優勢
jinja2之因此被普遍使用是由於它具備如下優勢:css
- 相對於Template,jinja2更加靈活,它提供了控制結構,表達式和繼承等。
- 相對於Mako,jinja2僅有控制結構,不容許在模板中編寫太多的業務邏輯。
- 相對於Django模板,jinja2性能更好。
- Jinja2模板的可讀性很棒。
安裝jinja2
因爲jinja2屬於第三方模塊,首先須要對其進行安裝html
1
|
pip3 install jinja2
|
測試模板是否安裝成功java
1
2
3
4
|
python
-
c
"import jinja2"
# 沒有報錯就表示安裝成功
# 必須用雙引號"
|
jinja2語法
做爲一個模板系統,它還提供了特殊的語法,咱們按照它支持的語法進行編寫以後,就能使用jinja2模塊進行渲染。python
1、基本語法
在jinja2中,存在三種語法:django
-
- 控制結構 (邏輯代碼){% %}
- 變量取值 {{ }}
- 註釋 {# #}
下面是一個簡單的jinja2例子api
{% for file in filenames %} ... {% endfor %}
能夠看到,for循環的使用方式和Python比較相似,可是沒有了句尾的冒號,另外須要使用endfor最爲結尾,其實在jinja2中,if也是同樣的,結尾須要使用endif。安全
jinja2模板中使用 {{ }} 語法表示一個變量,它是一種特殊的佔位符。當利用jinja2進行渲染的時候,它會把這些特殊的佔位符進行填充/替換,jinja2支持python中全部的Python數據類型好比列表、字段、對象等。函數
1
2
3
|
<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中的過濾器
變量能夠經過「過濾器」進行修改,過濾器能夠理解爲是jinja2裏面的內置函數和字符串處理函數。post
經常使用的過濾器有:
過濾器名稱 | 說明 |
safe | 渲染時值不轉義 |
capitialize | 把值的首字母轉換成大寫,其餘子母轉換爲小寫 |
lower | 把值轉換成小寫形式 |
upper | 把值轉換成大寫形式 |
title | 把值中每一個單詞的首字母都轉換成大寫 |
trim | 把值的首尾空格去掉 |
striptags | 渲染以前把值中全部的HTML標籤都刪掉 |
join | 拼接多個值爲字符串 |
replace | 替換字符串的值 |
round | 默認對數字進行四捨五入,也能夠用參數進行控制 |
int | 把值轉換成整型 |
那麼如何使用這些過濾器呢? 只須要在變量後面使用管道(|)分割,多個過濾器能夠鏈式調用,前一個過濾器的輸出會做爲後一個過濾器的輸入。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
{{
'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中的控制結構
jinja2中的if語句相似與Python的if語句,它也具備單分支,多分支等多種結構,不一樣的是,條件語句不須要使用冒號結尾,而結束控制語句,須要使用endif關鍵字
1
2
3
4
5
6
7
|
{%
if
daxin.safe %}
daxin is safe.
{% elif daxin.dead %}
daxin is dead
{%
else
%}
daxin is okay
{% endif %}
|
jinja2中的宏
宏相似於Python中的函數,咱們在宏中定義行爲,還能夠進行傳遞參數,就像Python中的函數同樣同樣兒的。
在宏中定義一個宏的關鍵字是macro,後面跟其 宏的名稱和參數等
1
2
3
4
5
|
{% macro input(name,age=18) %} # 參數age的默認值爲18
<input
type
=
'text'
name=
"{{ name }}"
value=
"{{ age }}"
>
{% endmacro %}
|
調用方法也和Python的相似
1
2
|
<p>{{ input(
'daxin'
) }} </p>
<p>{{ input(
'daxin'
,age=20) }} </p>
|
jinja2中的繼承和super函數
jinja2中最強大的部分就是模板繼承。模板繼承容許咱們建立一個基本(骨架)文件,其餘文件從該骨架文件繼承,而後針對本身須要的地方進行修改。
jinja2的骨架文件中,利用block關鍵字表示其包涵的內容能夠進行修改。
如下面的骨架文件base.html爲例:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<!
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。那怎麼進行繼承和變量替換呢?注意看下面的文件
1
2
3
4
5
6
7
8
9
10
11
12
|
{
%
extend
"base.html"
%
}
# 繼承base.html文件
{
%
block title
%
} Dachenzi {
%
endblock
%
}
# 定製title部分的內容
{
%
block head
%
}
{{
super
() }}
# 用於獲取原有的信息
<style
type
=
'text/css'
>
.important { color:
#FFFFFF }
<
/
style>
{
%
endblock
%
}
# 其餘不修改的原封不一樣的繼承
|
PS: super()函數 表示獲取block塊中定義的原來的內容。
因爲jinja2屬於第三方模塊,首先須要對其進行安裝
1
|
pip3 install jinja2
|
測試模板是否安裝成功
1
2
3
4
|
python
-
c
"import jinja2"
# 沒有報錯就表示安裝成功
# 必須用雙引號"
|