详解Django的 form_valid_message() 函数：返回表单验证成功后的消息

Django form_valid_message()函数的作用及使用

form_valid_message() 函数是 Django 中常用的表单验证函数，用于验证 ValidateFormMixin 类中 form_valid() 成功返回时的提示信息。在提交表单并验证通过后，会通过该函数来设置成功信息，提示用户操作成功。

使用 form_valid_message() 函数需要导入 messages 模块，该模块提供了不同类型的提示函数，如 messages.warning(), messages.success(), messages.info() 以及 messages.error()。

下面是该函数的完整格式：

def form_valid_message(self):
    messages.success(self.request, "Your message here")
    return super().form_valid()

接下来我们将通过实例来详细说明该函数的使用。

示例一：添加成功提示信息

假设我们要编写一份表单保存数据的视图，且保存成功后需要提供给用户一个成功的提示，这时候我们可以使用 form_valid_message() 函数。

from django.contrib import messages
from django.views.generic import CreateView
from myapp.forms import MyForm

class MyCreateView(CreateView):
    form_class = MyForm
    template_name = 'myapp/mytemplate.html'

    def form_valid(self, form):
        messages.success(self.request, "The data has been saved successfully!")
        return super().form_valid(form)

在该示例中，我们使用 CreateView 子类 MyCreateView 来处理表单保存的逻辑。在 form_valid() 中使用 messages.success() 函数来添加成功提示信息。

示例二：添加错误提示信息

在表单验证过程中有可能出现错误，若有出错，则可使用 form_invalid() 函数来添加错误提示信息，下面是一个示例：

from django.contrib import messages
from django.views.generic import FormView
from myapp.forms import MyForm

class MyFormView(FormView):
    form_class = MyForm
    template_name = 'myapp/mytemplate.html'

    def form_valid(self, form):
        return super().form_valid(form)

    def form_invalid(self, form):
        messages.error(self.request, "There are some errors in your form.")
        return super().form_invalid(form)

在该示例中，我们使用 FormView 子类 MyFormView 来处理表单验证。在 form_invalid() 中使用 messages.error() 函数来添加错误提示信息。

总结

在 Django 中，使用 form_valid_message() 函数能够较为方便地添加表单的成功提示信息。同时，在表单验证过程中，使用 messages 模块能够很好地管理表单验证的错误信息，为用户提供更好的提示和反馈。