信息闪烁¶

好的应用程序和用户界面都是关于反馈的。如果用户没有得到足够的反馈，他们可能最终会讨厌这个应用程序。flask提供了一种非常简单的方法，通过闪烁系统向用户提供反馈。闪烁系统基本上可以在请求结束时记录一条消息，并在下一个请求和下一个请求时访问它。这通常与执行此操作的布局模板结合在一起。请注意，浏览器和Web服务器有时会强制限制cookie的大小。这意味着，对会话cookie而言，闪烁的消息太大，会导致消息闪烁以静默方式失败。

简单闪烁¶

下面是一个完整的例子：

from flask import Flask, flash, redirect, render_template, \
     request, url_for

app = Flask(__name__)
app.secret_key = b'_5#y2L"F4Q8z\n\xec]/'

@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' or \
                request.form['password'] != 'secret':
            error = 'Invalid credentials'
        else:
            flash('You were successfully logged in')
            return redirect(url_for('index'))
    return render_template('login.html', error=error)

这里是 layout.html 有魔力的模板：

<!doctype html>
<title>My Application</title>
{% with messages = get_flashed_messages() %}
  {% if messages %}
    <ul class=flashes>
    {% for message in messages %}
      <li>{{ message }}</li>
    {% endfor %}
    </ul>
  {% endif %}
{% endwith %}
{% block body %}{% endblock %}

这是：file：index.html`模板，它继承自：file：`layout.html：

{% extends "layout.html" %}
{% block body %}
  <h1>Overview</h1>
  <p>Do you want to <a href="{{ url_for('login') }}">log in?</a>
{% endblock %}

这里是：file：login.html`模板，它也继承自：file：`layout.html：

{% extends "layout.html" %}
{% block body %}
  <h1>Login</h1>
  {% if error %}
    <p class=error><strong>Error:</strong> {{ error }}
  {% endif %}
  <form method=post>
    <dl>
      <dt>Username:
      <dd><input type=text name=username value="{{
          request.form.username }}">
      <dt>Password:
      <dd><input type=password name=password>
    </dl>
    <p><input type=submit value=Login>
  </form>
{% endblock %}

按类别闪烁¶

Changelog

在 0.3 版本加入.

也可以在闪烁消息时提供类别。如果未提供任何内容，则默认类别为 'message' . 可以使用其他类别为用户提供更好的反馈。例如，错误消息可以以红色背景显示。

要使用不同类别的消息，只需使用 flash() 功能：

flash('Invalid password provided', 'error')

在模板内你必须告诉：func：`~flask.get_flashed_messages`函数也返回类别。在那种情况下，循环看起来略有不同：

{% with messages = get_flashed_messages(with_categories=true) %}
  {% if messages %}
    <ul class=flashes>
    {% for category, message in messages %}
      <li class="{{ category }}">{{ message }}</li>
    {% endfor %}
    </ul>
  {% endif %}
{% endwith %}

这只是如何呈现这些闪烁消息的一个示例。也可以使用类别为消息添加前缀，例如“<strong>错误：</ strong>``。

过滤快闪信息¶

Changelog

在 0.9 版本加入.

或者，您可以传递一个类别列表，其中筛选 get_flashed_messages() . 如果希望在单独的块中呈现每个类别，这将非常有用。

{% 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 %}

信息闪烁¶

简单闪烁¶

按类别闪烁¶

过滤快闪信息¶

Contents

Navigation