开发: C++知识库 Java知识库 JavaScript Python PHP知识库人工智能区块链大数据移动开发嵌入式开发工具数据结构与算法开发测试游戏开发网络协议系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑笔记本显卡显示器固态硬盘硬盘耳机手机 iphone vivo oppo 小米华为单反装机图拉丁

-> Python知识库 -> Flask框架——模板变量、控制块、过滤器 -> 正文阅读

[Python知识库]Flask框架——模板变量、控制块、过滤器

在上篇文章中，我们学习了Flask框架——重定向、url_for，这篇文章我们学习Flask框架——模板变量、控制块、过滤器。

模板变量

控制块

过滤器

自定义过滤器

add_template_filter()

使用装饰器自定义过滤器

模板变量

模板是包含静态数据和动态数据占位符的文件。模板使用指定的数据生成最终的文档。 Flask使用Jinja模板库来渲染模板，是一个 web 开发必备的模块。因为我们在渲染一个网页的时候，并不是只渲染一个纯文本字符串，而是需要使用模板了。

在Flask框架中，我们通常使用render_template()方法来渲染模板，其语法格式为：

render_template(模板名,key=value,key=value)

具体代码如下所示：

from flask import Flask, render_template
?
app=Flask(__name__)
?
@app.route('/show')
def index():
 ? ?name='小明'
 ? ?return render_template('show_data.html')
?
if __name__ == '__main__':
 ? ?app.run(port=8080,debug=True)

那么我们如何把视图函数中的name变量传入show_data.html文件中呢？

只需要在render_template()方法中，传入参数即可，代码如下：

@app.route('/show')
def index():
 ? ?name='小明'
 ? ?return render_template('show_data.html',name=name)

这样就成功传递name变量在模板文件show_data.html文件中了。

注意：

由于render_template()默认是从templates文件夹中获取模板文件，所以我们一般都是把模板文件放在templates文件中；
key的值是任意的，value的值是变量名。

那么模板文件如何接收传入的变量呢？首先在模板中获取视图函数的变量值的语法为：

{{ 变量名key }}

在show_data.html文件内容如下：

<!DOCTYPE html>
<html lang="en">
<head>
 ? ?<meta charset="UTF-8">
 ? ?<title>展示信息</title>
</head>
<body>
<div>用户信息展示</div>
<p>
 ?  用户名是：{{ name }}
</p>
</body>
</html>

在p标签中，我们通过{{ name }}来接收在视图函数中传入的变量，这样就成功接收到了视图函数传入的变量了，打开如下URL链接：

http://127.0.0.1:8080/show

URL链接展示网页如下图所示：

这里我们成功传入了字符串，除了传入字符串，还可以传入列表、字典、对象等，视图函数代码如下所示：

class Motion:
 ? ?def __init__(self,name,time):
 ? ? ? ?self.name=name
 ? ? ? ?self.time=time
?
 ? ?def __str__(self):
 ? ? ? ?return self.name
?
@app.route('/show')
def index():
 ? ?name='小明'
 ? ?list_data=['北京','上海','广州','深圳']
 ? ?work={'work1':'python工程师','work2':'java开发工程师','work3':'数据分析师'}
 ? ?#实例化对象
 ? ?Motion1=Motion('打篮球','48分钟')
 ? ?return render_template('show_data.html',name=name,list1=list_data,work=work,motion=Motion1)

这里我们创建了字符串、列表、字典、Motion对象并实例化对象，并通过render_template()方法将这些变量传入到模板文件中，模板文件show_data.html文件如下：

<div>用户信息展示</div>
<p>
 ?  用户名是：{{ name }} -----视图函数没有传入变量{{ gender }}
?
 ? ?<br>整个列表为：{{ list1 }} ? ----获取列表中单个值{{ list1.2 }}
 ? ?<br>整个字典数据为：{{ work }}  -----获取字典中的某个值{{ work.work2 }} 或者{{ work.get('work1') }}
 ? ?<br>获取对象的某个属性值{{ motion.time }}
</p>

打开如下URL链接：

http://127.0.0.1:8080/show

运行结果如下图所示：

控制块

当我们想在模板中循环遍历变量或者对变量做判断时，这时可以使用控制块，控制块语法格式如下：

#循环遍历
{% for 变量 in 可迭代对象 %}
     {{ 变量 }} 
{% endfor %}

# 判断语句
{% if 条件 %}
  {{ 变量 }}
{% else %}
  {{ 变量 }}
{% elif %}
  {{ 变量 }}
{% endif %}

注意：控制块中，for一定要和endfor成对存在。

首先我们编写视图函数，代码如下所示：

from flask import Flask, render_template

app=Flask(__name__)

@app.route('/index')
def index():
    places=['北京','上海','广州','深圳','东莞','佛山']
    return render_template('show.html',place=places)

if __name__ == '__main__':
    app.run(port=8080,debug=True)

在视图函数中，我们把列表places传入了模板show.html中。

模板show.html文件代码如下所示：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>控制块展示</title>
</head>
<body>
    
<ul>
{% for places in place %}
    {% if places=='北京' %}
        <li> {{ places }} </li>
    {% else  %}
        <a href="">{{ places }}</a>
    {% endif %}
{% endfor %}
</ul>

</body>
</html>

这里我们循环遍历变量并通过if判断来创建li标签或a标签，打开下面的URL链接：

http://127.0.0.1:8080/index

该URL链接页面如下图所示：

通过控制块，我们就可以根据变量来动态地创建很多标签。

例如：根据变量创建表格

视图函数如下所示：

from flask import Flask, render_template

app=Flask(__name__)

@app.route('/index')
def index():
    register_data=[
        {'name': '小明', 'password': '123', 'phone': '137xxxxxxxx'},
        {'name': '小芳', 'password': '456', 'phone': '139xxxxxxxx'},
        {'name': '小洪', 'password': '789', 'phone': '138xxxxxxxx'},
        {'name': '小张', 'password': '123', 'phone': '135xxxxxxxx'},
    ]
    return render_template('show.html',register_data=register_data)

if __name__ == '__main__':
    app.run(port=8080,debug=True)

模板show.html代码如下所示：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>控制块展示</title>
</head>
<body>

<table border="1" cellpadding="0" cellspacing="0">
    {% for user in register_data %}
        <tr>
        <td>{{ loop.index }}</td>
        <td>{{ user.name }}</td>
        <td>{{ user.password }}</td>
        <td>{{ user.phone }}</td>
        </tr>
    {% endfor %}
</table>

</body>
</html>

在第一个td标签中，我们使用了loop.index，这样就可以让表格顺序排序号

打开下面的URL：

http://127.0.0.1:8080/index

该url链接页面如下图所示：

除了顺序排序，还有以下排序：

loop.index0：序号从0开始；
loop.revindex：倒序排序；
loop.revindex0：从0开始倒序排序；
loop.first：布尔类型，是否是第一行；
loop.last：布尔类型，是否是第二行；
等等。

这样当视图函数中的变量发生变化时，模板show.html文件就会根据变量来创建表格。

注意：控制块的代码是通过Jinja模板库来渲染，当我们只是运行show.html文件时控制块的代码只是相当于字符串，如下图所示：

过滤器

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

过滤器语法如下所示：

{{  变量名 | 过滤器  }}
{{  变量名 | 过滤器(参数)}}

示例代码如下所示：

首先编写视图函数，代码如下所示：

from flask import Flask, render_template

app=Flask(__name__)

@app.route('/index')
def index():
    msg='<h1>欢迎学习Flask框架</h1>'
    return render_template('show2.html',msg=msg)

if __name__ == '__main__':
    app.run(port=8080,debug=True)

模板文件show.html代码如下所示：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>过滤器的使用</title>
</head>
<body>
{# 转译 #}
{{ msg }}
{{ msg | safe }}

</body>
</html>

打开以下URL链接：

http://127.0.0.1:8080/index

该URL展示的网页如下图所示：

这里我们使用了safe过滤器，其作用是禁用转译。

打开网页源代码，如下图所示：

当我们没有用safe过滤器时，网页是直接把h1标签转译为大于小于号和h1。

常见的过滤器：

字符串过滤器：

safe ：禁用转译
capitalize ：首字母大写；
lower ：字母全小写
upper ：字母全大写
title ：一句话中每个单词的首字母大写
reverse ：翻转
format ：格式输出；
truncate ：字符串截断；
striptags：渲染之前把值中所有的HTML标签都删掉。

列表过滤器：

first：取第一个元素；
last：取最后一个元素；
length：获取列表长度；
sum：列表求和；
sort：列表排序。

语句过滤器：

{% filter upper %}
    代码块
{% endfilter %}

自定义过滤器

有时Flask框架内置的过滤器不满足我们的需求时，这时可以自定义过滤器来满足我们的需求，自定义过滤器有两种方法：通过add_template_filter()方法自定义过滤器、通过装饰器自定义过滤器。

add_template_filter()

在视图函数中通过add_template_filter()自定义过滤器，其语法格式如下所示：

def 函数名():
	方法
app.add_template_filter(函数名,'自定义过滤器方法名')

这样就成功自定义过滤器了。

示例代码如下：

from flask import Flask, render_template

app=Flask(__name__)

@app.route('/')
def index():
    msg='hello'
    return render_template('define_fillter.html',msg=msg)
    
# 第一种方法   使用add.template_filter()
def replace_hello(value):
    value=value.replace('hello','thanks')
    return value
app.add_template_filter(replace_hello,'replace1')

if __name__ == '__main__':
    app.run(port=8080,debug=True)

这里我们使用定义了replace_hello()函数，其作用是将hello替换为thanks，然后通过app.add_template_filter()方法使函数变为自定义过滤器。

模板define_fillter.html文件如下所示：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>自定义过滤器</title>
</head>
<body>
{{ msg }}
<hr>
{{ msg | replace1 }}
</body>
</html>

打开以下URL链接：

http://127.0.0.1:8080/

该网页如下图所示：

使用装饰器自定义过滤器

通过装饰器自定义过滤器与定义路由函数差不多，其语法格式如下所示：

@app.template_filter('自定义过滤器名')
def 函数名(参数):
    参数=参数.replace('hello','thanks')
    return 参数

示例代码如下所示：

from flask import Flask, render_template

app=Flask(__name__)

@app.route('/')
def index():
    msg='hello'
    return render_template('define_fillter.html',msg=msg)


# 第二种方法   使用装饰器
@app.template_filter('replace1')
def reverse_list(value):
    value=value.replace('hello','thanks')
    return value
if __name__ == '__main__':
    app.run(port=8080,debug=True)

这里我们自定义过滤器的作用也是将hello替换为thanks，模板define_fillter.html文件与上面的的模板文件内容一样，运行结果也与上面的一样，这里就不多描述了。

好了，Flask框架——模板变量、控制块、过滤器的知识就讲到这里了，下篇文章继续学习Flask框架的其他内容，感谢观看！！！