Jinja2模版和过滤器

最新推荐文章于 2025-03-13 19:36:14 发布

CCChenhao997

最新推荐文章于 2025-03-13 19:36:14 发布

阅读量342

点赞数

分类专栏： Flask 文章标签： Jinja2 过滤器

本文链接：https://blog.youkuaiyun.com/qq_35687547/article/details/103026324

版权

Flask 专栏收录该内容

2 篇文章

订阅专栏

原文链接 http://chenhao.space/post/7e478f5a.html

模版

视图函数的主要作用是生成请求的响应，这是最简单的请求。实际上，视图函数有两个作用：处理业务逻辑和返回响应内容。在大型应用中，把业务逻辑和表现内容放在一起，会增加代码的复杂度和维护成本。模板的作用即是承担视图函数的另一个作用，即返回响应内容。

模板其实是一个包含响应文本的文件，其中用占位符(变量)表示动态部分，告诉模板引擎其具体的值需要从使用的数据中获取
使用真实值替换变量，再返回最终得到的字符串，这个过程称为“渲染”
Flask是使用 Jinja2 这个模板引擎来渲染模板

使用模板的好处：

视图函数只负责业务逻辑和数据处理(业务逻辑方面)
而模板则取到视图函数的数据结果进行展示(视图展示方面)
代码结构清晰，耦合度低

Jinja2模版

两个概念：

Jinja2：是 Python 下一个被广泛应用的模板引擎，是由Python实现的模板语言，他的设计思想来源于 Django 的模板引擎，并扩展了其语法和一系列强大的功能，其是Flask内置的模板语言。
模板语言：是一种被设计来自动生成文档的简单文本格式，在模板语言中，一般都会把一些变量传给模板，替换模板的特定位置上预先定义好的占位变量名。

渲染模版函数

Flask提供的 render_template 函数封装了该模板引擎。
render_template 函数的第一个参数是模板的文件名，后面的参数都是键值对，表示模板中变量对应的真实值。

演示

from flask import Flask, render_template

app = Flask(__name__)


# 1.如何返回一个网页(模板)
# 2.如何给模版填充一个数据
@app.route("/")
def index():
    return render_template("index.html")


if __name__ == "__main__":
    app.run(debug=True)

index.html中的内容：

<!doctype html>
<html>

<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>

<body>
    这是模板 <br>
    这是首页 <br>
</body>

</html>

返回结果：

传入变量：

def index():
    # 比如需要传入网址
    url_str = "www.baidu.com"
    return render_template("index.html", url_str=url_str)

<body>
    这是模板 <br>
    这是首页 <br>
    {{ url_str }} <br>
</body>

变量代码块的使用

注释

使用 {# #} 进行注释

{# 这是注释 #}

变量代码块

{{ }} 来表示变量名，这种 {{ }} 语法叫做变量代码块

{{ post.title }}

Jinja2 模版中的变量代码块可以是任意Python类型或者对象，只要它能够被Python的str()方法转换为一个字符串就可以,比如,可以通过下面的方式显示一个字典或者列表中的某个元素:

{{your_dict['key']}}
{{your_list[0]}}

演示

from flask import Flask, render_template

app = Flask(__name__)


# 1.如何返回一个网页(模板)
# 2.如何给模版填充一个数据
@app.route("/")
def index():
    # 比如需要传入网址
    url_str = "www.baidu.com"
    my_list = [1, 3, 5, 7, 9]
    my_dict = {"name": "Chenhao's Studio", "url": "www.chenhao.space"}

    # 通常，模板中使用的变量名和要传递的数据的变量名保持一致
    return render_template("index.html", url_str=url_str, my_list=my_list, my_dict=my_dict)


if __name__ == "__main__":
    app.run(debug=True)

<!doctype html>
<html>

<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>

<body>
    这是模板 <br>
    这是首页 <br>

    {#下面是一个变量代码块的使用#}
    {{ url_str }} <br>

    {#列表的使用#}
    {{ my_list }} <br>
    {{ my_list.2 }} <br>
    {{ my_list[2] }} <br>

    {#字典的使用#}
    {{ my_dict }} <br>
    {{ my_dict.url }} <br>
    {{ my_dict['url'] }} <br>

</body>

</html>

控制代码块

用 {%%} 定义的控制代码块，可以实现一些语言层次的功能，比如循环或者if语句

{% if user %}
    {{ user }}
{% else %}
    hello!

{% for index in indexs %}
    {{ index }} 
{% endfor %}

演示

只需在index.html 的body中添加以下代码:

		<hr>
    {#for循环的使用#}
    {% for num in my_list %}
        {#数据大于3，才能显示#}
        {% if num > 3 %}
            {{ num }} <br>
        {% endif %}
    {% endfor %}

返回结果:

过滤器

过滤器的本质就是函数。有时候我们不仅仅只是需要输出变量的值，我们还需要修改变量的显示，甚至格式化、运算等等，而在模板中是不能直接调用 Python 中的某些方法，那么这就用到了过滤器。

使用方式：

过滤器的使用方式为：变量名 | 过滤器。

{{variable | filter_name(*args)}}

如果没有任何参数传给过滤器,则可以把括号省略掉

{{variable | filter_name}}

常见内建过滤器

字符串操作

safe：禁用转义

<p>{{ '<em>hello</em>' | safe }}</p>

capitalize：把变量值的首字母转成大写，其余字母转小写

<p>{{ 'hello' | capitalize }}</p>

lower：把值转成小写

<p>{{ 'HELLO' | lower }}</p>

upper：把值转成大写

<p>{{ 'hello' | upper }}</p>

title：把值中的每个单词的首字母都转成大写

<p>{{ 'hello' | title }}</p>

reverse：字符串反转

<p>{{ 'olleh' | reverse }}</p>

format：格式化输出

<p>{{ '%s is %d' | format('name',17) }}</p>

striptags：渲染之前把值中所有的HTML标签都删掉

<p>{{ '<em>hello</em>' | striptags }}</p>

truncate: 字符串截断

<p>{{ 'hello every one' | truncate(9)}}</p>

列表操作

first：取第一个元素

<p>{{ [1,2,3,4,5,6] | first }}</p>

last：取最后一个元素

<p>{{ [1,2,3,4,5,6] | last }}</p>

length：获取列表长度

<p>{{ [1,2,3,4,5,6] | length }}</p>

sum：列表求和

<p>{{ [1,2,3,4,5,6] | sum }}</p>

sort：列表排序

<p>{{ [6,2,3,1,5,4] | sort }}</p>

语句块过滤

{% filter upper %}
    一大堆文字
{% endfilter %}

链式调用

在 jinja2 中，过滤器是可以支持链式调用的，示例如下：

{{ "hello world" | reverse | upper }}

演示

		{#过滤器#}

    {#字符串变大写#}
    {{ url_str | upper }} <br>
    {#字符串反转#}
    {{ url_str | reverse }} <br>
    {#过滤器链式调用#}
    {{ url_str | upper | reverse }}

返回结果: