Сообщения всплывающие сообщения

Хорошие приложения и пользовательские интерфейсы — это всё о фидбеке. Если пользователь не получает достаточного отклика, он, скорее всего, возненавидит приложение. Flask предоставляет очень простой способ предоставления обратной связи пользователю с помощью системы всплывающих сообщений. Система всплывающих сообщений по сути позволяет записывать сообщение в конце запроса и получать доступ к нему в следующем запросе и только в следующем запросе. Обычно это сочетается с шаблоном макета, который это делает. Обратите внимание, что браузеры, а иногда и веб-серверы, накладывают ограничения на размер файлов 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 %}

Вот шаблон index.html, который наследуется от layout.html:

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

И вот шаблон login.html, который также наследуется от 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 %}

Всплывающие сообщения с категориями

Журнал изменений

Новое в версии 0.3.

Также можно указывать категории при всплывании сообщения. По умолчанию категория, если ничего не указано, — 'message'. Можно использовать альтернативные категории, чтобы предоставить пользователю лучшую обратную связь. Например, сообщения об ошибках можно отображать с красным фоном.

Чтобы всплыть сообщение с другой категорией, просто используйте второй аргумент функции flash():

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

В шаблоне вам нужно сообщить функции 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>Error:</strong> к сообщению.

Фильтрация всплывающих сообщений

Журнал изменений

Новое в версии 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 %}

© 2007–2020 Pallets
Licensed under the BSD 3-clause License.
https://flask.palletsprojects.com/en/1.0.x/patterns/flashing/