نموذج 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.

في 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