思源笔记

# jinjia2-模板渲染

# 概述

Jinja是一个Python的模板引擎，它被广泛用于Web应用程序中的HTML模板渲染。它具有高度的可定制性，支持基于继承和模块化的模板编写，使用人性化的语法，可以方便地进行变量插值、循环迭代、条件分支、模板继承等操作。

Jinja的核心设计理念是分离应用程序逻辑和UI层。这意味着你可以在一个地方编写你的业务逻辑，而在另一个地方编写你的模板，然后将两者组合起来生成HTML响应。这种分离和组合的方法使得Web应用程序的开发变得更加灵活和可维护。

Jinja可以与多种Web框架（如Flask、Django等）无缝集成，并支持自定义扩展。此外，Jinja还具有良好的性能和缓存机制，可以提高Web应用程序的响应速度。

‍

# jinja2特性

  1. 变量插值：使用双括号​将变量嵌入到模板中。例如，​会被Jinja2解析成相应变量的值。
  2. 控制结构：使用控制结构，如{% if %}​, {% for %}​, {% while %}​等进行条件判断和循环迭代。例如，{% for item in items %} {% endfor %}​会循环迭代一个名为items​的列表，并将每个元素渲染到模板中。
  3. 模板继承：使用{% extends %}​和{% block %}​实现模板继承，使得重复的HTML结构可以复用，并允许不同页面有不同的继承层次结构。
  4. 宏（Macro）：可以使用{% macro %}​定义和调用宏。宏类似于函数，可以封装一些重复的HTML结构或代码逻辑，以便复用和提高可维护性。
  5. 自定义过滤器：可以使用​语法自定义过滤器，使用类似管道的方式对变量进行预处理，例如格式化日期、转换大小写等。
  6. 自定义函数：使用jinja2.Environment()​方法创建自己的环境，并定义自定义函数进行复杂的计算和逻辑处理。
  7. 错误处理：通过{% try %}​和{% except %}​结构实现对特定代码块的错误检测和处理。

以上是Jinja2中比较重要和经常使用到的一些特性，更全面的文档可以查看Jinja2官方文档。

‍

# 使用示例

from jinja2 import Environment, FileSystemLoader

env = Environment(loader=FileSystemLoader('templates'))

template = env.get_template('index.html')

name = 'Lucas'
items = ['apple', 'banana', 'orange']

output = template.render(name=name, items=items)

print(output)

在上面的代码中，我们首先创建了一个名为env​的Environment​对象，并使用FileSystemLoader​加载templates​目录中的模板。然后，我们使用env.get_template()​方法从该目录中加载名为index.html​的模板。

接着，我们定义了两个变量name​和items​，分别包含一个字符串和一个列表。最后，我们使用模板的render()​方法将这些变量渲染到模板中，并获取渲染后的HTML输出字符串。

​index.html​模板可能如下所示：

<!DOCTYPE html>
<html>
    <head>
        <title>My Website</title>
    </head>
    <body>
        <h1>Hello, {{ name }}!</h1>

        <ul>
            {% for item in items %}
                <li>{{ item }}</li>
            {% endfor %}
        </ul>
    </body>
</html>

在这个例子中，我们在模板中使用双括号​将变量嵌入到HTML中，并使用控制结构{% for %}​和{% endfor %}​迭代items​列表，并将每个元素输出为HTML列表项。

当我们运行上面的代码时，Jinja2会解析index.html​模板，将变量和控制结构渲染到模板中，并输出渲染后的HTML字符串。最后，我们将输出字符串打印到控制台中。

这是一个简单的使用Jinja2直接渲染模板的例子，它展示了如何加载、渲染和输出模板。

← memoryview-内存view →