Django 消息框架

Django 消息框架是一个非常有用的工具，它可以让你向用户发送消息和提示。这些消息和提示可以是成功信息、错误信息、警告信息等等，可以是针对某个操作的提示，也可以是针对整个应用的提示。

使用 Django 消息框架，你可以非常方便地将消息嵌入到你的视图中，然后在模板中渲染出来。Django 消息框架提供了几种消息类型，包括：成功信息、错误信息、警告信息和信息消息。

安装 Django 消息框架

安装 Django 消息框架非常简单，只需使用 pip 命令即可：

pip install django-messages

然后，在 settings.py 中添加 messages 应用程序：

INSTALLED_APPS = [
    # ...
    'django.contrib.messages',
    # ...
]

MIDDLEWARE = [
    # ...
    'django.contrib.messages.middleware.MessageMiddleware',
    # ...
]

使用 Django 消息框架

使用 Django 消息框架非常简单，只需在视图中添加消息即可。例如，在一个视图中添加一条成功信息：

from django.contrib import messages
from django.shortcuts import render, redirect

def my_view(request):
    # ...
    messages.success(request, '操作已经成功完成！')
    return redirect('some-view')

然后，在你的模板中，你可以使用 messages 模板标签来循环遍历所有消息，并渲染它们：

{% if messages %}
    <ul class="messages">
        {% for message in messages %}
            <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>{{ message }}</li>
        {% endfor %}
    </ul>
{% endif %}

消息类型

Django 消息框架提供了四种消息类型：

• messages.success(request, message, extra_tags='')：成功。
• messages.error(request, message, extra_tags='')：错误。
• messages.warning(request, message, extra_tags='')：警告。
• messages.info(request, message, extra_tags='')：信息。

在示例中，我们展示了如何添加成功消息。其他类型的消息也可以以同样的方式添加。

添加标签

你可以为你的消息添加标签。标签可以是任何字符串，但它们用于在模板中显示消息。

例如，在视图中添加一条带有 special 标签的错误消息：

from django.contrib import messages
from django.shortcuts import render, redirect

def my_view(request):
    # ...
    messages.error(request, '出现了一个错误。', extra_tags='special')
    return redirect('some-view')

然后在模板中，你可以使用 special 标签：

{% if messages %}
    <ul class="messages">
        {% for message in messages %}
            <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>{{ message }}</li>
        {% endfor %}
    </ul>
{% endif %}

{% if messages %}
    <ul class="messages">
        {% for message in messages %}
            {% if message.tags == 'special' %}
                <li class="{{ message.tags }}">{{ message }}</li>
            {% endif %}
        {% endfor %}
    </ul>
{% endif %}

结论

Django 消息框架是一个非常有用的工具，它可以帮助你向用户发送消息和提示。在本教程中，我们介绍了如何安装和使用 Django 消息框架，以及如何将消息嵌入到视图中，并在模板中渲染出来。同时，我们还介绍了如何为消息添加标签，以便在模板中过滤和显示它们。