Quart框架模板使用指南：从基础到高级技巧-优快云博客

Quart框架模板使用指南：从基础到高级技巧

quart An async Python micro framework for building web applications. 项目地址: https://gitcode.com/gh_mirrors/qu/quart

模板引擎概述

Quart框架采用了Jinja2作为其默认模板引擎，这是一个功能强大且广泛使用的模板系统。模板在Web开发中扮演着重要角色，它允许开发者将业务逻辑与展示逻辑分离，提高代码的可维护性和可读性。

基本模板渲染

Quart提供了两个核心函数用于模板渲染：

render_template - 用于渲染指定模板文件
render_template_string - 用于直接渲染模板字符串

这两个函数都是异步的，使用时需要加上await关键字。它们都接受额外的关键字参数，这些参数将作为上下文传递给模板。

@app.route('/')
async def index():
    return await render_template('index.html', title='首页', user=current_user)

标准上下文变量

Quart自动向所有模板注入了一些有用的全局变量：

config - 当前应用的配置对象
request - 当前请求对象
session - 会话对象
g - 请求全局变量

这些变量可以直接在模板中使用：

<p>当前端点: {{ request.endpoint }}</p>
<p>应用名称: {{ config['APP_NAME'] }}</p>

模板全局函数

Quart还提供了两个实用的全局函数：

url_for - 用于生成URL
get_flashed_messages - 用于获取闪现消息

使用示例：

<a href="{{ url_for('user.profile', user_id=current_user.id) }}">我的资料</a>

{% for message in get_flashed_messages() %}
    <div class="alert">{{ message }}</div>
{% endfor %}

自定义模板功能

自定义过滤器

Quart允许开发者创建自定义模板过滤器，这可以通过装饰器或函数方式实现：

# 装饰器方式
@app.template_filter('reverse')
def reverse_filter(s):
    return s[::-1]

# 函数方式
def capitalize_filter(s):
    return s.capitalize()
app.add_template_filter(capitalize_filter, 'capitalize')

在模板中使用：

<p>{{ "hello" | reverse }}</p>  <!-- 输出: olleh -->
<p>{{ "world" | capitalize }}</p>  <!-- 输出: World -->

自定义测试

测试用于在模板中进行条件判断，可以这样定义：

@app.template_test('even')
def is_even(num):
    return num % 2 == 0

模板中使用：

{% if 42 is even %}
    <p>42是偶数</p>
{% endif %}

上下文处理器

上下文处理器允许我们向模板自动注入变量。Quart支持应用级和蓝图级的上下文处理器：

# 应用级 - 对所有请求有效
@app.context_processor
async def inject_app_data():
    return {'app_name': current_app.name}

# 蓝图级 - 仅对蓝图路由的请求有效
@blueprint.context_processor
async def inject_blueprint_data():
    return {'blueprint_name': blueprint.name}