6.6. Forms

6.6.1. Forms

6.6.2. Simple "contact us" form

class ContactUsForm(forms.Form):
    sender = forms.EmailField()
    subject = forms.CharField()
    body = forms.CharField(widget=forms.Textarea)

class ContactUsView(FormView):
    template_name = 'addressbook/contact-form.html'
    form_class = ContactUsForm
    success_url = '/thank-you.html'


class ThankYouView(TemplateView):
    template_name = 'addressbook/thank-you.html'

forms.py

from django import forms


class ContactForm(forms.Form):
    subject = forms.CharField(max_length=100)
    message = forms.CharField(widget=forms.Textarea)
    sender = forms.EmailField()
    cc_myself = forms.BooleanField(required=False)

    def clean_sender(self):
        data = self.cleaned_data['sender']

        if "mark.watney@nasa.gov" not in data:
            raise forms.ValidationError("You have forgotten about Watney!")

        # Always return a value to use as the new cleaned data, even if
        # this method didn't change it.
        return data

views.py

from django.http import HttpResponseRedirect
from django.shortcuts import render

from .forms import NameForm

def get_name(request):
    # if this is a POST request we need to process the form data
    if request.method == 'POST':
        # create a form instance and populate it with data from the request:
        form = NameForm(request.POST)
        # check whether it's valid:
        if form.is_valid():
            # process the data in form.cleaned_data as required
            # ...
            # redirect to a new URL:
            return HttpResponseRedirect('/thanks/')

    # if a GET (or any other method) we'll create a blank form
    else:
        form = NameForm()

    return render(request, 'name.html', {'form': form})

form.html

<form action="/your-name/" method="post">
    {% csrf_token %}
    {{ form }}
    <input type="submit" value="Submit">
</form>

• {{ form.as_table }} will render them as table cells wrapped in <tr> tags

• {{ form.as_p }} will render them wrapped in <p> tags

• {{ form.as_ul }} will render them wrapped in <li> tags

6.6.3. Model Forms

from django.db import models

class Person(models.Model):
    firstname = models.CharField(verbose_name=_('First Name'), max_length=30)
    lastname = models.CharField(verbose_name=_('Last Name'), max_length=30, db_index=True)
    phone = models.IntegerField(verbose_name=_('Phone'), null=True, blank=True)
    date_of_birth = models.DateField(verbose_name=_('Date of birth'), null=True, blank=True)
    image = models.ImageField(verbose_name=_('Image'), upload_to='person/', null=True, blank=True)

    def __str__(self):
        return f'{self.firstname} {self.lastname}'

    class Meta:
        verbose_name = _('Person')
        verbose_name_plural = _('People')
        unique_together = ['firstname', 'lastname']

from django import forms
from .models import Person


class PersonForm(forms.ModelForm):
    class Meta:
        model = Person
        fields = ['firstname', 'lastname']

    def clean_firstname(self):
        firstname = self.cleaned_data['firstname']

        if 'x' in firstname:
            raise forms.ValidationError("X in firstname")
        else:
            return firstname

from .forms import PersonForm
from django.views.generic import FormView


class ContactCreate(FormView):
    template_name = 'addressbook/create.html'
    form_class = PersonForm
    success_url = '/contact.html'

    def form_valid(self, form):
        Person.objects.create(
            firstname=form.cleaned_data['firstname'],
            lastname=form.cleaned_data['lastname'],
        )
        return super().form_valid(form)

<form method="post">
    {% csrf_token %}

    <table>
        {{ form.as_table }}
    </table>

    <input type="submit" value="Send message">
</form>

6.6.4. Widgets

from django.forms import ModelForm, Textarea
from myapp.models import Author


class AuthorForm(ModelForm):
    class Meta:
        model = Author
        fields = ('name', 'title', 'birth_date')
        widgets = {
            'name': Textarea(attrs={'cols': 80, 'rows': 20}),
        }