创建 ModelForm 表单

本课属于 Coddy Django 学习旅程的“表单”单元。第 12 课，共 20 课。

把 EventForm 和 Event 模型并排来看：相同的字段写了两遍。ModelForm 会根据模型创建字段。对于 Book 模型：

from .models import Book


class BookForm(forms.ModelForm):
    class Meta:
        model = Book
        fields = ["title", "author", "pages"]

内部的 Meta 类会指定要使用的模型和字段。每个模型字段都会变成对应的表单字段，而 blank=True 会让该字段成为可选项。字段列表是必需的，这样之后添加到模型中的字段就不会意外出现在公开表单中。

clean_<field>() 和 clean() 在 Meta 旁边的用法也相同。表单还可以自行保存：form.save() 会根据 cleaned_data 创建一条记录并返回它。

挑战

简单

将 EventForm 改为 ModelForm。

在 events/forms.py 中，删除其中的六行字段代码，并添加一个 Meta，指定 Event 和它的六个字段：title、date、end_date、place、description、capacity。保留 clean_date() 和 clean()。
在 new_event 中，将 Event.objects.create() 替换为 form.save()。

添加一个日期在过去的活动：你仍会看到 The date cannot be in the past.

亲手试试

import datetime

from django import forms


class EventForm(forms.Form):
    title = forms.CharField(max_length=100)
    date = forms.DateField()
    end_date = forms.DateField(required=False)
    place = forms.CharField(max_length=100)
    description = forms.CharField(widget=forms.Textarea, required=False)
    capacity = forms.IntegerField(min_value=1)

    def clean_date(self):
        date = self.cleaned_data["date"]
        if date < datetime.date.today():
            raise forms.ValidationError("The date cannot be in the past.")
        return date

    def clean(self):
        cleaned_data = super().clean()
        date = cleaned_data.get("date")
        end_date = cleaned_data.get("end_date")
        if date and end_date and end_date < date:
            raise forms.ValidationError("The event cannot end before it starts.")
        return cleaned_data