使用Jinja2模板引擎生成html报告

myzbx 2025-01-07 14:26 43 浏览

Flask、Django Web框架都使用模板语言引擎进行web页面的渲染，Flask使用Jinja2作为其模板引擎，Jinja2是一个快速、表达力强、可扩展的模板引擎，它使用了类似于Python语法的特殊占位符，可以将模板和数据结合起来渲染出最终的文档。Jinja2是基于Python的，可以安装在任何支持Python的平台上。Jinja2还提供了一个可选的沙箱模板执行环境，可以保证模板的安全性。

Jinja2的使用不必依附于Web框架，它完全可以独立使用，相信很多人都有写各种报告文档的经历，如果某类型的文档要反复地写的话，可以考虑使用Jinja2来自动生成报告，事先准备好漂亮的模板文件，每次只要更新数据就可以自动生成漂亮的报告文档了。由于本文重点介绍Jinja2的基本使用方法，仅使用最简单的html模板进行说明，读者完全可以自己设计或下载满意的html页面作为模板使用。

Jinja2的基本用法是这样的：

首先，需要导入jinja2模块，并创建一个Environment对象，这个对象可以配置模板的加载方式、过滤器、变量等。
然后，需要加载一个模板文件，这个文件可以是一个本地的文件，也可以是一个字符串，或者是一个从其他地方获取的对象。
最后，需要调用模板的render方法，传入一些数据，这些数据可以是字典、列表、对象等，模板会根据这些数据生成最终的文档。

下面是一个简单的例子，演示了如何使用jinja2渲染一个HTML页面：

# 导入jinja2模块
import jinja2

# 创建一个Environment对象，指定模板的加载方式为文件系统
env = jinja2.Environment(loader=jinja2.FileSystemLoader('./templates'))

# 加载一个模板文件，这个文件的内容是一个HTML页面，其中有一些占位符
template = env.get_template('template.html')

# 定义一些数据，这些数据会替换模板中的占位符
data = {
    'title': 'Hello Jinja2',
    'name': 'Jinja2',
    'items': ['Python', 'Jinja2', 'Flask']
}

# 调用模板的render方法，传入数据，得到最终的文档
document = template.render(data)

# 打印或保存文档
print(document)
with open("report.html", 'w', encoding='utf-8') as f:
    f.write(document)

这个模板文件template.html的内容是这样的：

<html>
<head>
    <title>{{ title }}</title>
</head>
<body>
    <h1>Hello {{ name }}!</h1>
    <ul>
        <!-- for循环控制结构开始 -->
        {% for item in items %}
            <!-- if条件控制结构开始 -->
            {% if item == "Jinja2" %}
                <!-- loop.index变量表示循环迭代的序号  -->
                <li>{{loop.index}} <b>{{ item }}</b></li>
            {% else %}
                <!-- upper是内部过滤器，将item转换为大写，以|分割，前一个作为后续的输入  -->
                <li>{{loop.index}} {{ item|upper }}</li>
            {% endif %}
            <!-- if条件控制结束 -->
        {% endfor %}
        <!-- for循环控制结构结束 -->
	</ul>
</body>
</html>

这个模板文件中，使用了两种占位符：

{{ … }} 表示一个变量，它会被传入的数据中对应的值替换，变量可以使用upper这样的过滤器进行修改，以|分割，前一个作为后一个的输入。
{% … %} 表示一个控制结构，它可以实现一些逻辑，比如循环、判断、继承等。

渲染后的文档是这样的：

<html>
<head>
    <title>Hello Jinja2</title>
</head>
<body>
    <h1>Hello Jinja2!</h1>
    <ul>
		<li>1 PYTHON</li>
		<li>2 <b>Jinja2</b></li>
		<li>3 FLASK</li>
	</ul>
</body>
</html>

可以看到，模板中的占位符被数据中的值替换了，生成了一个简单的HTML页面。

参考文献

[1]. Jinja2内置过滤器清单模板设计者文档 — Jinja2 中文手册 2.8 documentation (pythontab.com)；

HTML 参考手册

上一篇：在线帮助文档的6大最佳创建方法，让用户更轻松地了解企业产品
下一篇：[Jsoup] HTML解析器，轻松获取网页内容

使用Jinja2模板引擎生成html报告

参考文献

相关推荐

使用VSCode模板提高Vue开发效率（vscode开发vue3）

吃透 Vue 项目开发实践|16个方面深入前端工程化开发技巧【下】

8.7k star，一款超炫酷的动态可视化大屏项目

说下你的vue项目的目录结构，该怎么划分?

用上Vue3，你真的变了吗?（vue3 key）

移动前端重构实战系列:5-7章（前端移动端主要技术有哪些）

这么牛逼的cursor功能，赶紧用起来

browser-use:AI 驱动的浏览器自动化神器——DOM识别与交互详解

巧克力:从一朵花开始的华丽变身_巧克力花束教程视频

comfyui安装MimicMotion扩展，AI跳舞动作模仿