收藏

模板系统 Jinja2(二)

2022-02-26  本文已影响0人  山药鱼儿

连载的上一篇文章,小鱼和大家一起学习了 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>
上一篇 下一篇

猜你喜欢

热点阅读