ModelForm基本使用

介绍

Django提供Form和ModelForm两种表单验证方式。相比较Form，ModelForm可以直接与与数据库表相关联，不需要像Form那样需要手动逐一字段添加表单验证的字段。且可以随意选择需要验证的表单字段。

ModelForm使用方法

新建ModelForm

其中：

model 是需要操作的数据库表；

fields是需要验证的字段，如果需要数据库表所有字段可以使用fields="__all__"；

widgets是插件，设置字段的输入方式及设置使用bootstrap时所需要的样式（有更好的实现方式）；

# rbac/forms/role.py
from django import forms
from rbac import models

class RoleModelForm(forms.ModelForm):
    """
    角色操作表单
    """
    class Meta:
        model = models.Role
        fields = ["title", ]
        widgets = {
            "title": forms.TextInput(attrs={"class": "form-control"})
        }

视图函数中使用ModelForm

视图函数中实例化RoleModelForm()对象并使用，

增加

选择要验证的数据：form = RoleModelForm(data=request.POST)

验证表单数据：form.is_valid()

保存数据： form.save()

def role_add(request):

    if request.method == "GET":
        form = RoleModelForm()
        return render(request, "rbac/change.html", {"form": form})
    form = RoleModelForm(data=request.POST)
    if form.is_valid():
        form.save()
        return redirect(reverse("rbac:role_list"))
    return render(request, "rbac/change.html", {"form": form})

编辑

编辑时默认显示初始值：form = RoleModelForm(instance=role_obj)

选择要验证并编辑的数据：form = RoleModelForm(instance=role_obj, data=request.POST)

def role_edit(request, pk):
    role_obj = models.Role.objects.filter(pk=pk).first()
    if not role_obj:
        return HttpResponse("要修改的数据不存在，请重新选择")
    if request.method == "GET":
        form = RoleModelForm(instance=role_obj)
        return render(request, "rbac/change.html", {"form": form})
    form = RoleModelForm(instance=role_obj, data=request.POST)
    if form.is_valid():
        form.save()
        return redirect(reverse("rbac:role_list"))
    return render(request, "rbac/change.html", {"form": form})

字段的增或减

增加(额外新增数据库表中不存在的字段)：

class UserAddModelForm(forms.ModelForm):
    confirm_password = forms.CharField(label="确认密码")
    class Meta:
        model = models.UserInfo
        fields = ["name", "email", "password", "confirm_password"]

减少(直接添加不需要验证的字段)：exclude = ["password"]

class UserEditModelForm(forms.ModelForm):
    class Meta:
        model = models.UserInfo
        exclude = ["password"]

不显示字段保存默认值

某种场景下需要页面不显示某个字段，但是在数据保存到数据库之前form.save()，

需要对不显示的字段手动设置默认值，此时需要使用form.instance

def permission_add(request, sid):
    ...
    form = PermissionModelForm(data=request.POST)
    if form.is_valid():
        p_obj = models.Permission.objects.filter(pk=sid).first()
        # pid是FK,自关联,此处需要赋值实例对象
        form.instance.pid = permission_obj
        form.save()
        ...

字段增加Bootstrap样式

单独添加：手动为每个字段添加widgets插件

class Meta:
        ...
        widgets = {
            "title": forms.TextInput(attrs={"class": "form-control"})
        }

批量添加：重写父类init方法，循环添加

class UserEditModelForm(forms.ModelForm):
    class Meta:
        ...
    def __init__(self, *args, **kwargs):
        super(UserEditModelForm, self).__init__(*args, **kwargs)
        for name, field in self.fields.items():
            field.widget.attrs["class"] = "form-control"

字段密文显示

两种方式：数据库表中的字段，数据库表外的新增字段

class UserAddModelForm(forms.ModelForm):
    confirm_password = forms.CharField(label="确认密码", widget=forms.PasswordInput()

    class Meta:
        model = models.UserInfo
        fields = ["name", "email", "password", "confirm_password"]
        widgets = {
            "password": forms.PasswordInput(),
        }

自定制错误信息提示

1）英文变中文可以设置配置文件settings.py 中的LANGUAGE_CODE = 'zh-hans'

2）显示格式自定制可增加插件error_messages

class Meta:
    model = models.UserInfo
    fields = ["name", "email", "password", "confirm_password"]
    error_messages = {
        "name": {"required": "用户名不能为空"}
    }