一、什么是消息闪现

一个好的应用和用户接口都有良好的反馈，否则到后来用户就会讨厌这个应用。 Flask 通过闪现系统来提供了一个易用的反馈方式。闪现系统的基本工作原理是在请求结束时记录一个消息，提供且只提供给下一个请求使用。通常通过一个布局模板来展现闪现的消息。
闪现系统的基本工作方式是：在且只在下一个请求中访问上一个请求结束时记录的消息。一般我们结合布局模板来使用闪现系统。注意，浏览器会限制 cookie 的大小，有时候网络服务器也会。这样如果消息比会话 cookie 大的话，那么会导致消息闪现静默失败。

二、基础用法

2.1 生成一个密钥

Flask在某些情况下，会要求生成一个密钥，这个密钥用于cookie、消息闪现等场景。
python命令行生成一个密钥

python -c "import secrets; print(secrets.token_hex())"

2.2 配置密钥

# 导入falsk
from flask import Flask, render_template, jsonify, request, flash, redirect, url_for

# 通过导入的falsk，创建一个app
app = Flask(__name__)
# 通过 python -c "import secrets; print(secrets.token_hex())" 来实现
app.secret_key = "16623b4eb38efb00f2b8e7f5359f80d1826caf0c77506856e1e12cfc53b0dc83"


# 路由
@app.route('/')
def index():
    return render_template('index.html')


@app.route('/login', methods=['GET', 'POST'])
def login():
    error = None
    if request.method == 'POST':
        if request.form['username'] == 'admin':
            flash('登录成功')
            return render_template("index.html")
        else:
            flash('登录失败')
            error = '用户名错误'
            # 另一种跳转方式
            return redirect(url_for('index'))
    return render_template('login.html', error=error)


# 开启运行
if __name__ == '__main__':
    app.run(debug=True)
    """
    debug,是否开启调试模式，开启后，重新启动程序，当再次修改Python代码后，会立即启动
    port,启动指定服务器的端口号，默认是5000
    host，主机，默认是127.0.0.1；如果指定0.0.0.0代表本机的所以IP    
    """

2.3 模板index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
{% with messages=get_flashed_messages() %}  {# 使用get_flashed_messages()方法获取消息#}
    {% if messages %}
        {% for message in messages %}
            {{ message }}
        {% endfor %}
    {% endif %}
{% endwith %}
</body>
</html>

2.4 模板login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="{{ url_for('login') }}" method="post">
    <p><input type="text" name="username" placeholder="输入用户名"></p>
    <p><input type="submit" value="提交"></p>
</form>
</body>
</html>

2.5 代码解释

从登录页面中login.html中登录后，会进入视图函数login中，其中，在试图函数中增加了flash("要传递的内容")方法，传递消息给下一个请求；登录成功与失败，都会跳转到index.html页面中，，然后再index.html模板中通过get_flashed_messages()方法进行获取，然后展示就能得到消息闪现出的内容。

三、闪现消息的类别

闪现消息还可以指定类别，如果没有指定，那么缺省的类别为 ‘message’ 。不同的类别可以给用户提供更好的反馈。例如错误消息可以使用红色背景。
使用 flash() 函数可以指定消息的类别:

flash('闪现消息的内容', 'error') 
# 这里第二个参数，就是类别，有意义即可

3.1 视图函数

@app.route('/login', methods=['GET', 'POST'])
def login():
    error = None
    if request.method == 'POST':
        if request.form['username'] == 'admin':
            # 第二个参数指定了类别
            flash('登录成功', 'ok')
            return render_template("index.html")
        else:
            # 第二个参数指定了类别
            flash('登录失败', 'err')
            error = '用户名错误'
            return redirect(url_for('index'))
    return render_template('login.html', error=error)

3.2 模板index.html

get_flashed_messages(with_categories=true)指定使用消息列表，那获取消息时就能得到消息类别了，这里类别与页面中的样式组合起来了。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>首页</title>

    <style>
        .ok {
            color: blue;
        }

        .err {
            color: red;
        }
    </style>

</head>
<body>
{% with messages=get_flashed_messages(with_categories=true) %}  {# 使用get_flashed_messages()方法获取消息#}
    {% if messages %}
        <ul>
            {% for category, message in messages %}
                <li class="{{ category }}">{{ message }}</li>
            {% endfor %}
        </ul>
    {% endif %}
{% endwith %}
</body>
</html>

四、过滤闪现消息

你可以视情况通过传递一个类别列表来过滤 get_flashed_messages() 的结果。这个功能有助于在不同位置显示不同类别的消息。

# 这里过滤到error分类
{% with errors = get_flashed_messages(category_filter=["error"]) %}
    {% if errors %}
        <div class="alert-message block-message error">
            <a class="close" href="#">×</a>
            <ul>
                {%- for msg in errors %}
                    <li>{{ msg }}</li>
                {% endfor -%}
            </ul>
        </div>
    {% endif %}
{% endwith %}