Python 模板 Jinja2

模板

要了解Jinja2，就需要先理解模板的概念。模板在Python的web开发中广泛使用，它能够有效的将业务逻辑和页面逻辑分开，使代码可读性更强、更加容易理解和维护。模板简单来说就是一个包含占位变量表示动态部分的文件，模板文件在经过动态赋值后，返回给用户(可理解为渲染)。Python中自带一个简单的模板，就是string提供的：

>>> import string
>>> temp = string.Template("$who is $role")
>>> temp.substitute(who="red hat", role="Linux")
'red hat is Linux'
>>> temp.substitute(who="opensource", role="software")
'opensource is software'
>>>

Python自带的模板功能极其有限，如果我们要在模板中使用控制语句、表达式和继承等功能的话，就无法实现。目前主流的模板系统，最常见的就是Jinja2和mako。

Jinja2

Jinja2是Flask作者开发的一个模板系统，起初是仿Django模板的一个模板系统，为Flask提供模板支持，由于其灵活性、快速和安全等优点呗广泛使用，其优点有：

相对于Template，Jinja2更加灵活，它提供了控制结构、表达式和继承等；
相对于Mako，Jinja2仅有控制结构，不允许在模板中编写太多业务逻辑；
相对于Django模板，Jinja2性能更好；
Jinja2模板可读性很棒；

安装Jinja2
由于Jinja2属于第三方包，首先需要对其进行安装：

pip install jinja2

测试Jinja2是否安装成功：

python -c "import jinja2"

# 必须使用双引号""，没有报错就表示安装成功

Jinja2语法

作为一个模板系统，它还提供了特殊的语法，我们按照它支持地语法进行编写之后，就能使用Jinja2模板进行渲染。
1.基本语法

控制结构：{% %}；
变量取值： {{ }}；
注释{# #}；

简单jinja2例子：

{# This is jinja2 code
    {% for file in filenames %}
        ...
    {% endfor %}
#}

可以看到，for循环的使用方式和Python比较类似，但是没有句尾的冒号，另外需要使用endfor作为结尾，其实在jinja2中，if也是一样的，结尾需要使用endif。

2.Jinja2变量
Jinja2模板中使用{{ }}语法表示一个变量，它是一种特殊的占位符。当利用Jinja2进行渲染时，它会把这些特殊的占位符进行填充/替换，Jinja2支持Python中所有的Python数据类型，比如：列表、字符串、对象等；

<p>this is a directory: {{ mydict["key"] }}</p>
<p>this is a list: {{ mylist[2] }}</p>
<p>this is a object: {{ myobject.something }}</p>

3.Jinja2中的过滤器
变量可以通过过滤器进行修改，过滤器可以理解为是Jinja2里面的内置函数和字符串处理函数。常用的过滤器有：

过滤器名称	说明
safe	渲染时值不转义
capitalize	把值得首字母转成大写，其他字母转成小写
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

4.Jinja2的控制结构
Jinja2中的if语句类似于Python的if语句，它也具有但分支、多分支等多种结构，不同的是，条件语句不需要使用冒号结尾，而结束控制语句，需要使用endif关键字。

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

5.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开始)

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

7.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 %}   
 
# 其他不修改的原封不同的继承

注：super()函数表示获取block块中定义的原来的内容。

利用Jinja2进行渲染

Jinja2模块中有一个名为Environment的类，这个类的实例用于存储配置和全局对象，然后从文件系统或其他位置中加载模板。
1.基本使用方法
大多数应用都在初始化的时候遇见一个Environment对象，并用它加载模板。Environment支持两种加载方式：

PackageLoader：包加载器
FileSystemLoader：文件系统加载器

2.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)   # 渲染

注意：

PackageLoader()两个参数为：Python包的名称、模板目录名称；
get_template()：获取模板目录下的某个具体文件；
render()：接收变量，对模板进行渲染；

3.FileSystemLoader
文件加载器，不需要模板文件存在某个Python包下，可以直接访问系统中的文件。