使用Python Flask Jinja2模板语法的方法介绍

一、概述

Flask是一个轻量级的Python Web框架，支持Jinja2模板引擎。Jinja2是一个流行的Python模板引擎，它可以使用Flask来创建动态Web应用程序。

web 页面一般需要html、css和js，可能最开始学习python web的时候可能这样写：

from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
    return '
hello
hello world!!!
'
if __name__ == '__main__':
	app.run(host='0.0.0.0', port=8000, debug=True)

上面的代码虽然也可以执行，但是不美观，现在编程基本上都是前后端分离，不会在后端代理嵌入前端的代码，为了实现前后端分离，使用MVT设计方案：

M 全拼为 Model，与MVC中的M功能相同，负责和数据库交互，进行数据处理。

V 全拼为 View，与MVC中的C功能相同，接收请求，进行业务处理，返回应答。

T 全拼为 Template，与MVC中的V功能相同，负责封装构造要返回的html。

二、JinJa2 语法介绍与示例讲解

JinJa2 语法介绍与示例讲解：

1）变量

在Jinja2中，使用{{ }}来包含一个变量。在Flask中，可以通过将变量传递给模板来显示它们。示例代码如下：

# variable.py
# Flask中将变量传递给模板
from flask import Flask, render_template
app = Flask(__name__)
# 也可指定模板目录
# app = Flask(__name__, template_folder="/opt/python-projects/flask")
@app.route('/')
def hello():
    name = "Alice"
    return render_template('variable.html', name=name)
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)

在上面的代码中，将变量 name 传递给 hello.html 模板。

    


    
hello {{ name }}!

执行

python3 variable.py

访问

curl http://192.168.182.110:8000/

2）控制结构

在Jinja2中，可以使用if、for和while等语句来控制模板中的输出。示例代码如下：

# if.py
# Flask中使用if控制结构
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/')
def hello():
    user = {"name": "Alice", "age": 25}
    return render_template('if.html', user=user)
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)

templates/if.html 模板文件

    


    {% if user %}
        {% if user.age >= 18 %}
            
Hello {{ user.name }}, you are an adult!
        {% else %}
            
Hello {{ user.name }}, you are a minor!
        {% endif %}
    {% else %}
        
Hello, anonymous user!
    {% endif %}

在上面的代码中，使用if语句来控制输出，根据用户的年龄显示不同的消息。

3）循环结构

在Jinja2中，可以使用 for 语句来循环输出模板中的内容。示例代码如下：

# for.py
# Flask中使用for循环结构
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/')
def hello():
    users = [{"name": "Alice", "age": 25}, {"name": "Bob", "age": 30}]
    return render_template('for.html', users=users)
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)

templates/for.html 模板文件

    


    {% for user in users %}
        
Hello {{ user.name }}!
        
You are {{ user.age }} years old.
    {% endfor %}

在上面的代码中，使用 for 循环来遍历用户列表，并输出每个用户的信息。

4）宏

在Jinja2中，可以使用宏来定义一段可以重复使用的代码块，示例代码如下：

# great.py
# Flask中使用宏
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/')
def hello():
    users = [{"name": "Alice", "age": 25}, {"name": "Bob", "age": 30}]
    return render_template('great.html', users=users)
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)

定义一个宏 templates/macros.html 模板

# 定义一个宏
{% macro print_user(user) %}
    
Hello {{ user.name }}!
    
You are {{ user.age }} years old.
{% endmacro %}

在上面的代码中，定义了一个名为 print_user 的宏，在模板中可以通过 import 导入宏，并使用宏来输出用户信息。模板 templates/great.html

    


    {% for user in users %}
        {% import 'macros.html' as macros %}
        {{ macros.print_user(user) }}
    {% endfor %}

在上面的代码中，定义了一个名为print_user的宏，用于输出用户信息。

5）过滤器

在Jinja2中，过滤器可以对变量进行处理，例如格式化日期、转换大小写等。示例代码如下：

# filter.py
# Flask中使用过滤器
from flask import Flask, render_template
import datetime
app = Flask(__name__)
@app.route('/')
def hello():
    now = datetime.datetime.now()
    return render_template('filter.html', now=now)
# 自定义过滤器
@app.template_filter('datetimeformat')
def datetimeformat(value, format='%Y-%m-%d %H:%M:%S'):
    return value.strftime(format)
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)

模板文件 templates/filter.html

    


    
The current date and time is: {{ now|datetimeformat }}

在上面的代码中，定义了一个名为 datetimeformat 的过滤器，用于格式化日期和时间。这里是自定义过滤器，其实 JinJa2 也内置了一些过滤器。Jinja2中内置过滤器：jinja.palletsprojects.com/en/3.0.x/te…

6）继承

在Jinja2中，可以使用继承来创建一个包含共同元素的模板，并通过继承该模板来创建更具体的模板。示例代码如下：

# extend.py
# Flask中使用继承
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/')
def hello():
    return render_template('extend.html')
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)

模板文件 templates/base.html

    


    {% block content %}{% endblock %}

模板文件 templates/extend.html

{% extends "base.html" %}
{% block title %}Hello{% endblock %}
{% block content %}
    
Hello World!
{% endblock %}

在上面的代码中，定义了一个名为 base.html 的模板，并在 extend.html 模板中继承了该模板。extend.html 模板中可以重写 base.html 模板中的块，并在其中添加新的内容。

7）包含

在Jinja2中，可以使用包含来将一个模板包含到另一个模板中。示例代码如下：

# contain.py
# Flask中使用包含
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/')
def hello():
    return render_template('contain.html')
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000, debug=True)

模板文件 templates/contain.html

    


    {% block content %}{% endblock %}
    {% include "footer.html" %}

模板文件 templates/footer.html

在上面的代码中，定义了一个名为 footer.html 的模板，并在 contain.html 模板中使用包含将 footer.html 模板包含到页面底部。这样，可以避免在每个页面中重复添加相同的页脚。