Python模塊學習 - jinja2

時間 2019-11-11

標籤 python 模塊學習 jinja2 jinja 欄目 Python 简体版

原文原文鏈接

模板

　　要了解jinja2，那麼須要先理解模板的概念。模板在Python的web開發中普遍使用，它可以有效的將業務邏輯和頁面邏輯分開，使代碼可讀性加強、而且更加容易理解和維護。javascript

　　模板簡單來講就是一個其中包涵佔位變量表示動態的部分的文件，模板文件在通過動態賦值後，返回給用戶。 --> 能夠理解爲渲染css

　　python中自帶一個簡單的模板，就是string提供的。html

>>> import string
>>> a = string.Template('$who is $role')
>>> a.substitute(who='daxin',role='Linux')
'daxin is Linux'
>>> a.substitute(who='daxin',role='cat')
'daxin is cat'
>>>

　　Python自帶的模板功能極其有限，若是咱們想要在模板中使用控制語句，和表達式，以及繼承等功能的話，就沒法實現了。java

　　目前主流的模板系統，最經常使用的就是jinja2和makopython

jinja2介紹

　　jinja2是Flask做者開發的一個模板系統，起初是仿django模板的一個模板引擎，爲Flask提供模板支持，因爲其靈活，快速和安全等優勢被普遍使用。web

jinja2的優勢

　　jinja2之因此被普遍使用是由於它具備如下優勢：django

相對於Template，jinja2更加靈活，它提供了控制結構，表達式和繼承等。
相對於Mako，jinja2僅有控制結構，不容許在模板中編寫太多的業務邏輯。
相對於Django模板，jinja2性能更好。
Jinja2模板的可讀性很棒。

安裝jinja2

　　因爲jinja2屬於第三方模塊，首先須要對其進行安裝api

pip3 install jinja2

　　測試模板是否安裝成功安全

python -c "import jinja2"

# 沒有報錯就表示安裝成功
# 必須用雙引號"

jinja2語法

　　做爲一個模板系統，它還提供了特殊的語法，咱們按照它支持的語法進行編寫以後，就能使用jinja2模塊進行渲染。函數

基本語法

　　在jinja2中，存在三種語法：

1. 控制結構 {% %}
2. 變量取值 {{ }}
3. 註釋 {# #}

　　下面是一個簡單的jinja2例子

{# This is jinja code 

	{% for file in filenames %}
	...
	{% endfor %}

#}

　　能夠看到，for循環的使用方式和Python比較相似，可是沒有了句尾的冒號，另外須要使用endfor最爲結尾，其實在jinja2中，if也是同樣的，結尾須要使用endif。

jinja2變量

　　jinja2模板中使用 {{ }} 語法表示一個變量，它是一種特殊的佔位符。當利用jinja2進行渲染的時候，它會把這些特殊的佔位符進行填充/替換，jinja2支持python中全部的Python數據類型好比列表、字段、對象等。

<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裏面的內置函數和字符串處理函數。

　　經常使用的過濾器有：

過濾器名稱	說明
safe	渲染時值不轉義
capitialize	把值的首字母轉換成大寫，其餘子母轉換爲小寫
lower	把值轉換成小寫形式
upper	把值轉換成大寫形式
title	把值中每一個單詞的首字母都轉換成大寫
trim	把值的首尾空格去掉
striptags	渲染以前把值中全部的HTML標籤都刪掉
join	拼接多個值爲字符串
replace	替換字符串的值
round	默認對數字進行四捨五入，也能夠用參數進行控制
int	把值轉換成整型

　　那麼如何使用這些過濾器呢？只須要在變量後面使用管道(|)分割，多個過濾器能夠鏈式調用，前一個過濾器的輸出會做爲後一個過濾器的輸入。

{{ '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關鍵字。

{% if daxin.safe %}
daxin is safe.
{% elif daxin.dead %}
daxin is dead
{% else %}
daxin is okay
{% endif %}

jinja2的for循環

　　jinja2中的for循環用於迭代Python的數據類型，包括列表，元組和字典。在jinja2中不存在while循環。

　　迭代列表

<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>

固然也能夠加入else語句，在循環正確執行完畢後，執行

在for循環中，jinja2還提供了一些特殊的變量，用以來獲取當前的遍歷狀態：

變量	描述
loop.index	當前迭代的索引（從1開始）
loop.index0	當前迭代的索引（從0開始）
loop.first	是不是第一次迭代，返回bool
loop.last	是不是最後一次迭代，返回bool
loop.length	序列中的項目數量
loop.revindex	到循環結束的次數（從1開始）
loop.revindex0	到循環結束的次數(從0開始）

jinja2的宏

　　宏相似於Python中的函數，咱們在宏中定義行爲，還能夠進行傳遞參數，就像Python中的函數同樣同樣兒的。

　　在宏中定義一個宏的關鍵字是macro，後面跟其宏的名稱和參數等

{% macro input(name,age=18) %}   # 參數age的默認值爲18

 <input type='text' name="{{ name }}" value="{{ age }}" >

{% endmacro %}

　　調用方法也和Python的相似

<p>{{ input('daxin') }} </p>
<p>{{ input('daxin',age=20) }} </p>

jinja2的繼承和Super函數

　　jinja2中最強大的部分就是模板繼承。模板繼承容許咱們建立一個基本(骨架)文件，其餘文件從該骨架文件繼承，而後針對本身須要的地方進行修改。

　　jinja2的骨架文件中，利用block關鍵字表示其包涵的內容能夠進行修改。

　　如下面的骨架文件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。那怎麼進行繼承和變量替換呢？注意看下面的文件

{% 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進行渲染

　　jinja2模塊中有一個名爲Enviroment的類，這個類的實例用於存儲配置和全局對象，而後從文件系統或其餘位置中加載模板。

基本使用方法

　　大多數應用都在初始化的時候撞見一個Environment對象，並用它加載模板。Environment支持兩種加載方式：

- PackageLoader：包加載器
- FileSystemLoader：文件系統加載器

PackageLoader

　　使用包加載器來加載文檔的最簡單的方式以下：

from jinja2 import PackageLoader,Environment
env = Environment(loader=PackageLoader('python_project','templates'))    # 建立一個包加載器對象

template = env.get_template('bast.html')    # 獲取一個模板文件
template.render(name='daxin',age=18)   # 渲染

　　其中：