ModelForm

חלק מהיחידה טפסים במסלול ה-Django של Coddy. שיעור 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:

השדות שלו מגיעים מ־Event: title, date, end_date, place, description, capacity.
שורות השדות מוסרות; clean_date() ו־clean() נשארות.
new_event מאפשרת לטופס ליצור את האירוע.

לחצו על Run והוסיפו אירוע.

נסו בעצמכם

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