5.2 模板语法详解

Flask模板语法详解：控制结构、过滤器与标签 - 从入门到精通

Flask 中文教程

本教程全面讲解Flask中Jinja2模板的语法，详细解析控制结构（if条件、for循环）、模板过滤器（内置与自定义）和模板标签（宏定义、include标签），附带代码示例，帮助新人快速掌握Flask模板使用。

Flask模板语法详解

Flask是一个基于Python的轻量级Web框架，它使用Jinja2作为默认的模板引擎。模板引擎允许你将动态数据嵌入到HTML中，使Web开发更高效。本教程将详细讲解Jinja2模板的语法，包括控制结构、过滤器和标签，适合Flask初学者。

1. 模板引擎简介

在Flask中，模板文件通常以.html后缀存储，但它们可以包含Jinja2语法。Jinja2是一个快速、灵活的模板引擎，Flask通过render_template函数渲染模板。例如，从路由返回一个模板：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    data = {'name': 'Alice', 'age': 25}
    return render_template('index.html', **data)

在模板中，你可以使用Jinja2语法访问数据：{{ name }}会输出“Alice”。

2. 模板语法基础

Jinja2语法基于双大括号{{ }}用于输出表达式，以及大括号百分号{% %}用于控制结构。例如：

{{ variable }}：输出变量的值。
{% statement %}：执行控制语句，如if或for。

3. 控制结构详解

控制结构用于在模板中添加逻辑判断和循环，使页面更具动态性。

3.1 if 条件语句

使用{% if condition %}来执行条件判断。语法支持if、elif、else和endif。

示例代码：

<!-- 模板文件：if_example.html -->
{% if user.is_authenticated %}
    <p>欢迎, {{ user.name }}!</p>
{% else %}
    <p>请先登录。</p>
{% endif %}

在Flask中，传递给模板的数据可能包含user对象，is_authenticated是一个布尔值。如果条件为真，显示欢迎信息；否则，显示登录提示。

常见用法：

检查用户状态：{% if current_user.is_authenticated %}（结合Flask-Login扩展）。
条件显示元素：{% if error %}<p class="error">{{ error }}</p>{% endif %}。

3.2 for 循环语句

使用{% for item in iterable %}来遍历列表、字典或其他可迭代对象。以{% endfor %}结束。

示例代码：

<!-- 模板文件：for_example.html -->
<ul>
{% for user in users %}
    <li>{{ user.name }} - {{ user.email }}</li>
{% endfor %}
</ul>

在Flask中，从视图函数传递一个用户列表：users = [{'name': 'Alice', 'email': 'alice@example.com'}, {'name': 'Bob', 'email': 'bob@example.com'}]。循环会生成一个无序列表。

高级特性：

循环索引：使用loop.index获取当前迭代的索引（从1开始），loop.index0从0开始。例如：{% for item in items %}{{ loop.index }}: {{ item }}{% endfor %}。
循环控制：break和continue在Jinja2中不可用，但可以使用条件语句模拟。

4. 模板过滤器详解

过滤器用于在输出变量时进行格式转换或处理。语法：{{ variable|filter_name }}。多个过滤器可以链式使用：{{ variable|filter1|filter2 }}。

4.1 内置过滤器

Jinja2提供了许多内置过滤器，以下是一些常用示例：

upper：将字符串转换为大写。示例：{{ "hello"|upper }} 输出 HELLO。
lower：将字符串转换为小写。示例：{{ "WORLD"|lower }} 输出 world。
capitalize：将字符串首字母大写。示例：{{ "flask tutorial"|capitalize }} 输出 Flask tutorial。
length：获取列表或字符串的长度。示例：{{ users|length }} 如果users是一个列表，输出其元素个数。
safe：标记字符串为安全HTML，避免自动转义。示例：{{ "<strong>bold</strong>"|safe }} 输出加粗文本。
default：提供默认值。示例：{{ variable|default("N/A") }} 如果variable未定义或为空，输出N/A。

示例代码：

<!-- 模板文件：filter_example.html -->
<p>原始名称: {{ name }}</p>
<p>大写: {{ name|upper }}</p>
<p>默认值: {{ age|default(0) }}</p>

4.2 自定义过滤器

你可以创建自定义过滤器来扩展Jinja2的功能。在Flask中，通过应用程序注册过滤器。

步骤：

定义一个Python函数。
使用@app.template_filter()装饰器注册它。

示例代码：

# app.py
from flask import Flask

app = Flask(__name__)

# 自定义过滤器：反转字符串
@app.template_filter('reverse')
def reverse_filter(s):
    return s[::-1]

# 在模板中使用
# {{ "hello"|reverse }} 输出 "olleh"

在模板中，使用：{{ "hello"|reverse }}，输出将是olleh。

5. 模板标签详解

模板标签是Jinja2中的高级功能，用于定义可重用组件或包含其他模板。

5.1 宏定义（Macros）

宏类似于函数，用于定义可重用的模板片段。使用{% macro macro_name(arguments) %}定义，以{% endmacro %}结束。在模板中调用宏：{{ macro_name(arguments) }}。

示例代码：

<!-- 模板文件：macros_example.html -->
{% macro input(name, value='', type='text') %}
    <input type="{{ type }}" name="{{ name }}" value="{{ value }}">
{% endmacro %}

<!-- 调用宏 -->
<form>
    {{ input('username') }}
    {{ input('password', type='password') }}
</form>

宏允许你在多个地方重用HTML代码，提高模板的可维护性。

5.2 include 标签

include标签用于将一个模板文件包含到另一个模板中，适合拆分大型模板。语法：{% include 'filename.html' %}。

示例代码：

假设有一个头部模板header.html：

<!-- header.html -->
<header>
    <h1>我的网站</h1>
    <nav>
        <a href="/">首页</a>
        <a href="/about">关于</a>
    </nav>
</header>

在主模板中包含它：

<!-- main.html -->
<!DOCTYPE html>
<html>
<head>
    <title>Flask教程</title>
</head>
<body>
    {% include 'header.html' %}
    <main>
        <p>这是主要内容。</p>
    </main>
</body>
</html>

include简化了模板管理，使代码更模块化。

6. 综合示例

以下是一个Flask应用的简单示例，展示如何结合使用控制结构、过滤器和标签。

视图函数：

# app.py
from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def home():
    users = [
        {'name': 'Alice', 'age': 30},
        {'name': 'Bob', 'age': 25},
        {'name': 'Charlie', 'age': 35}
    ]
    message = "Welcome to Flask"
    return render_template('home.html', users=users, message=message)

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

模板文件：

<!-- home.html -->
<!DOCTYPE html>
<html>
<head>
    <title>Flask模板示例</title>
</head>
<body>
    <h1>{{ message|upper }}</h1>
    
    <h2>用户列表</h2>
    <ul>
    {% for user in users %}
        <li>{{ user.name }} - {{ user.age|default("Unknown") }}</li>
    {% endfor %}
    </ul>
    
    <!-- 使用宏 -->
    {% macro display_user(name, age) %}
        <p>姓名: {{ name }}, 年龄: {{ age }}</p>
    {% endmacro %}
    {{ display_user("Dave", 40) }}
    
    <!-- 包含其他模板 -->
    {% include 'footer.html' %}
</body>
</html>

假设footer.html包含一些页脚信息。

7. 总结

本教程详细介绍了Flask中Jinja2模板的语法：

控制结构：使用if条件和for循环添加逻辑和迭代。
模板过滤器：内置过滤器如upper、lower等，以及如何创建自定义过滤器扩展功能。
模板标签：宏定义用于代码重用，include标签用于模板模块化。

通过这些工具，你可以轻松构建动态、可维护的Web应用。练习是关键，尝试修改示例代码来加深理解。Flask的官方文档和Jinja2文档也是宝贵的资源。

祝你学习愉快！

上一章 5.1 模板基础使用

下一章 5.3 模板继承与复用

Flask 中文教程

5.2 模板语法详解

Flask模板语法详解

1. 模板引擎简介

2. 模板语法基础

3. 控制结构详解

3.1 if 条件语句

3.2 for 循环语句

4. 模板过滤器详解

4.1 内置过滤器

4.2 自定义过滤器

5. 模板标签详解

5.1 宏定义（Macros）

5.2 include 标签

6. 综合示例

7. 总结

相关文档

Python 教程

FastAPI 教程

Django 6中文教程

NumPy 中文教程

Scikit-learn 中文教程

TensorFlow 中文手册