Un formulaire de modèle

Fait partie de la section Formulaires du Journey Django de Coddy. Leçon 12 sur 20.

Regarde EventForm et le modèle Event côte à côte : les mêmes champs, écrits deux fois. Un ModelForm construit ses champs à partir du modèle. Pour un modèle Book :

from .models import Book


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

La classe interne Meta indique le modèle et les champs à utiliser. Chaque champ du modèle devient le champ de formulaire correspondant, et blank=True le rend facultatif. La liste est obligatoire : ainsi, un champ ajouté ultérieurement au modèle ne se retrouve jamais par accident dans un formulaire public.

clean_<field>() et clean() fonctionnent de la même manière à côté de Meta. Et le formulaire s’enregistre lui-même : form.save() crée la ligne à partir de cleaned_data et la renvoie.

Défi

Facile

Transformez EventForm en ModelForm :

Ses champs proviennent de Event : title, date, end_date, place, description, capacity.
Supprimez les lignes des champs ; conservez clean_date() et clean().
new_event permet au formulaire de créer l’événement.

Cliquez sur Run et ajoutez un événement.

Essayez vous-même

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