Django ModelForm用法详解

在上一节《Django Form基于Model定义表单》我们使用 ModelForm 定义了一个基于模型 UserInfo 的一张表单，整个实现的过程也非常的类似于 Form 对象的实现过程，在本节我们将对 ModelForm 中涉及的一些细节做一下介绍，那么我们先从 Meta 元数据项开始。

1. 常用的Meta选项

在上节一中，我们 class Meta 中使用了一些元数据项，比如说 exclude、labels 以及 fields，当然还有些其他的选项，在 Django 官方网站 ModelForm 的定义如下所示

modelform_factory（model，form = ModelForm，fields = None，exclude = None，formfield_callback = None，widgets = None，localized_fields = None，labels = None，help_texts = None，error_messages = None，field_classes = None)

在这里给大家依次进行介绍这些 Meta 选项。

1) fields

其为列表或元组类型，与 exclude 相反，它指定当前的表单应该包含哪些字段，如果要所有的 Model 字段都包含在表单中，可以设定 fields='__all__'。ModelForm 的定义中必须要包含 fields 或 exclude 选项，否则将会抛出异常，同时给出错误提示：

Creating a ModelForm without either the'fields'attribute or the'exclude'attribute is prohibited。

2) labels

其为字典类型，用于定义表单字段的名称（输入框左边显示的名称）。表单字段的名称首先会使用 Model 字段定义设置的 verbose_name，如果没有设置，则直接使用字段名。因此当没有定义 verbo se_name 时，就可以使用 labels 选项来指定字段名。例如：

labels={
'title'：'标题'，、
'price':'价格'
}

3) help_texts

其为字典类型，用于给表单字段添加帮助信息。目前页面中表单字段的帮助信息（输入框下方显示的内容）来自 Model字段的 help_texts 定义，如果没有定义则什么都不显示。help_texts 的定义方式与 labels  选项类似，例如：

help_texts={
"title":"书籍的名称"
"price':"书籍价格"
}

4) widgets

其为字典类型，用于定义表单字段选用的控件。默认情况下，ModelForm 会根据Model字段的类型映射表单 Field 类，因此会应用 Field 类中默认定义的 widgets。这个选项用于自定义控件类型，例如：

class Meta:
    model=UserInfo
    fields="__all__"
    widgets={'password':widgets.PasswordInput()}

5) field_classes

字典类型，用于指定表单字段使用的 Field 类型。默认情况下，对于 title 字段，ModelForm 会将它映射为 fields.CharField 类型。可以根据需要改变这种默认行为，例如，将 title 设置为如下类型：

field_calss={"title":forms.URLField}

6) error_messages

字典类型，用来指定表单字段校验规则，即验证失败时的报错信息。

上面的字段只是常用的 Mata 选项，若大家感兴趣，同样也可以参阅官方文档《Model Form Functions》对此处的知识点进行学习。

2. ModelForm的save()方法

在上一节《Django Form基于Model定义表单》的 user_add_form 视图函数中，它将所有的 Model 字段都定义在 ModelForm 中，此时，字段值通过校验 is_valid 之后，我们使用了 ModelForm 提供的 save 方法实现了 Model 对象的保存。ModelForm 的 save 方法定义于它的基类 BaseModelForm中，其源代码在 Django 中实现如下：

def save(self, commit=True):
    if self.errors:
        raise ValueError(
            "The %s could not be %s because the data didn't validate." % (
                self.instance._meta.object_name,
                'created' if self.instance._state.adding else 'changed',
            )
        )
    if commit:
        # 除了保存当前Model实例，还会保存多对多关系数据
        self.instance.save()
        self._save_m2m()
    else:
        # 将保存多对多数据方法赋值给save_m2m，save返回后可以手动调用
        # saving of m2m data.
        self.save_m2m = self._save_m2m
    return self.instance
save.alters_data = True

通过源码不难理解它的实现逻辑，下面主要讲解一下 save 方法的基本使用，主要有三个场景。如下所示：1) 通过页面 Post 提交过来的数据，通过 form 接收 ，然后直接保存到数据库，同时能够产生对应的 models 的一个新对象，如下所示：

f = BookForm(request.POST)
new_book = f.save()

2) 从数据库中取出 models 的对象，然后通过 form 参数 instance 方法能够实例化该 form，这个主要用来查看具体的信息，如下所示：

a = Book.objects.get(id=1)
f = BookForm(instance=a)
f.save()

3) 如果既有 Post 又有 instance，则以 Post 提交数据为主，这个主要用来修改具体的信息。如下所示：

a = Book.objects.get(id=1)
f = BookForm(request.POST, instance=a)
f.save()

save 方法接受一个 commit 参数，默认为 True，可以实现 Model 实例的保存以及多对多关系数据的保存。如果在使用 save 方法时设置了 commit 为 False，则不会执行保存动作。此时，可以对返回的实例对象做一些操作后，再执行 save() 方法。

user=UserModelForm(request.Post)
if user.is_valid():
    user=user.save(commit=False)
    user.username=request.username
    user.save()
    return render(request,'index/user_add.html',locals())

本节内容也至此完毕，在下一节《Django表单系统工作原理详述》，我们将分析一下 Django 表单系统的工作原理，由浅入深，各位小伙伴要做好心里准备哦！