Sebuah ModelForm

Termasuk bagian Formulir dalam perjalanan Django di Coddy. Pelajaran 12 dari 20.

Lihat EventForm dan model Event berdampingan: field yang sama, ditulis dua kali. ModelForm membuat field-nya dari model. Untuk model Book:

from .models import Book


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

class Meta di dalam menamai model dan field yang akan digunakan. Setiap field model menjadi field formulir yang sesuai, dan blank=True menjadikannya opsional. Daftar field wajib ada, jadi field yang ditambahkan ke model nanti tidak akan tanpa sengaja masuk ke formulir publik.

clean_<field>() dan clean() berfungsi sama saat diletakkan bersama Meta. Formulir juga menyimpan dirinya sendiri: form.save() membuat baris dari cleaned_data lalu mengembalikannya.

Tantangan

Mudah

Ubah EventForm menjadi ModelForm:

Field-nya berasal dari Event: title, date, end_date, place, description, capacity.
Baris field dihapus, clean_date() dan clean() tetap ada.
new_event memungkinkan formulir membuat event.

Tekan Jalankan dan tambahkan event.

Coba sendiri

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