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で、6つのフィールド行を削除し、Eventとその6つのフィールド（title、date、end_date、place、description、capacity）を指定するMetaを追加します。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