Menu
CoddyTech

Um ModelForm

Parte da seção Forms do Journey de Django da Coddy. Lição 12 de 20.

Observe EventForm e o modelo Event lado a lado: os mesmos campos, escritos duas vezes. Um ModelForm cria seus campos a partir do modelo. Para um modelo Book:

from .models import Book


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

A classe interna Meta especifica o modelo e os campos a serem usados. Cada campo do modelo se torna o campo correspondente no formulário, e blank=True o torna opcional. A lista é obrigatória, então um campo adicionado posteriormente ao modelo nunca vai parar em um formulário público por acidente.

clean_<field>() e clean() funcionam da mesma forma ao lado de Meta. E o formulário salva a si mesmo: form.save() cria a linha a partir de cleaned_data e a retorna.

challenge icon

Desafio

Fácil

Transforme EventForm em um ModelForm.

  1. Em events/forms.py, exclua as seis linhas de campos e adicione uma Meta que especifique Event e seus seis campos: title, date, end_date, place, description, capacity. Mantenha clean_date() e clean().
  2. Em new_event, substitua Event.objects.create() por form.save().

Adicione um evento com data no passado: você ainda verá A data não pode estar no passado.

Experimente você mesmo

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

Todas as lições de Forms

Pratique por conta própria: Playground de Django