连载的上一篇文章,小鱼和大家一起学习了 Jinja2 的语法知识,本篇文章我们就来实践一下吧~
注:Flask 中很好地为我们集成了 Jinja2,如果是在 Flask 中使用 Jinja2 ,只需要使用
flask
包下面的render_template
函数即可。如果使用 Jinja2 管理配置文件,则需要我们了解 Jinja2 提供的 API。
Jinja2 API 介绍
Jinja 模块提供了 Environment
类,在应用初始化时,我们使用 Environment
类实例化一个 env
对象,用这个实例化的对象来存储配置和加载模板。
比如,下面的代码,在实例化 Environment
对象时,使用的是包加载器 PackageLoader
配置 Jinja:
from jinja2 import Environment, PackageLoader
env = Environment(loader=PackageLoader('Application', 'templates'))
上述使用包加载器初始化的 Environment
对象 env
会在 Application 这个 Python 包的 templates 目录下查找模板。
接下来,只需要以模板的名字作为参数调用 Environment.get_template
方法即可。该方法会返回一个模板,调用模板的 render
方法即可完成渲染。
template = env.get_template('山药鱼儿.txt')
template.render(motto='人能弘道,非道弘人')
其中模板 山药鱼儿.txt
中的内容如下:
山药鱼儿座右铭:{{motto}}。
渲染结果:
'山药鱼儿座右铭:人能弘道,非道弘人。'
除了包加载器外,还可以配置文件系统加载器,文件系统加载器不需要模板必须位于一个 Python 包下,可直接访问系统中的文件。我们在连载上一篇文章中使用的辅助函数 render
就使用了文件系统加载器:
import os
from jinja2 import Environment, FileSystemLoader
def render(tpl_path, **kwargs):
path, filename = os.path.split(tpl_path)
env = Environment(loader=FileSystemLoader(path or './'))
return env.get_template(filename).render(**kwargs)
比如在当前目录下有一个 template.txt
的模板文件,其内容为:
益者三乐,损者三乐。
乐{{good_1}},乐{{good_2}},乐{{good_3}},益矣。
乐{{bad_1}},乐{{bad_2}},乐{{bad_3}},损矣。
使用我们自定义的 render
函数就可以完成对模板的渲染:
render_str = render(
'template.txt',
good_1='节礼乐', good_2='道人之善', good_3='多贤友',
bad_1='骄乐', bad_2='佚游', bad_3='宴乐'
)
print(render_str)
渲染结果:
益者三乐,损者三乐。
乐节礼乐,乐道人之善,乐多贤友,益矣。
乐骄乐,乐佚游,乐宴乐,损矣。
示例 1
模板文件 template.html
中的内容如下:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
{# 使用过滤器去掉空格 #}
<title>{{ title | trim }}</title>
</head>
<body>
<ul>
{% for item in items %}
<li><a href="{{ item['href'] }}">{{ item['corpus'] }}</a></li>
{% endfor %}
</ul>
<p>{{ content }}</p>
</body>
</html>
上述模板使用 for
循环遍历一个列表,列表中的每一项为一个字典,字典中包含了文字和链接。此外,使用 Jinja 过滤器 trim
删除 Title 中的空格。
定义模板渲染函数:
def test_template():
title = ' 山药鱼儿 Mia '
items = [
{'corpus':'每日 Get 一个 Python 技能', 'href':'https://www.jianshu.com/nb/50215835'},
{'corpus':'Python 数据分析之常用库', 'href':'https://www.jianshu.com/nb/49600701'},
{'corpus':'数据分析师需要掌握的表格技巧', 'href':'https://www.jianshu.com/nb/51449584'}
]
content = "益者三友,损者三友。友直,友谅,友多闻,益矣。友便辟,友善柔,友便佞,损矣。"
result = render('template.html', **locals())
print(result)
**locals()
以字典的形式获取局部变量,传递给 render
函数。调用 test_template
打印渲染结果:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>山药鱼儿 Mia</title>
</head>
<body>
<ul>
<li><a href="https://www.jianshu.com/nb/50215835">每日 Get 一个 Python 技能</a></li>
<li><a href="https://www.jianshu.com/nb/49600701">Python 数据分析之常用库</a></li>
<li><a href="https://www.jianshu.com/nb/51449584">数据分析师需要掌握的表格技巧</a></li>
</ul>
<p>益者三友,损者三友。友直,友谅,友多闻,益矣。友便辟,友善柔,友便佞,损矣。</p>
</body>
</html>
网友评论