Form error handling in Django - Mini Project: Build & Apply

Form error handling

📖 Scenario: You are building a simple Django web page where users can submit their name and email. You want to make sure the form checks for errors like missing fields or invalid email format and shows helpful messages.

🎯 Goal: Create a Django form with fields name and email. Add validation to show error messages if the user leaves fields empty or enters an invalid email. Display these errors on the form page.

📋 What You'll Learn

Create a Django form class with name and email fields

Add a configuration variable to set a minimum length for the name field

Write validation logic in the form to check for empty fields and invalid email format

Update the Django view to handle form errors and pass them to the template

💡 Why This Matters

🌍 Real World

Form error handling is essential for any web application that collects user input to ensure data quality and provide helpful feedback.

💼 Career

Understanding Django form validation and error handling is a key skill for backend web developers working with Python and Django frameworks.

1

Create the Django form class

Create a Django form class called ContactForm with two fields: name as a CharField and email as an EmailField.

Django

from django import forms

# Define ContactForm with name and email fields
# Your code here

Need a hint?

Use forms.Form as the base class. Use forms.CharField() for name and forms.EmailField() for email.

2

Add a minimum length configuration

Add a variable called MIN_NAME_LENGTH and set it to 3 to specify the minimum length required for the name field.

Django

from django import forms

MIN_NAME_LENGTH = 3

class ContactForm(forms.Form):
    name = forms.CharField()
    email = forms.EmailField()
# Your code here

Need a hint?

Define MIN_NAME_LENGTH as a simple integer variable before the form class.

3

Add validation logic to the form

Inside the ContactForm class, add a method called clean_name that checks if the name field length is less than MIN_NAME_LENGTH. If so, raise a forms.ValidationError with the message 'Name must be at least 3 characters long.'.

Django

from django import forms

MIN_NAME_LENGTH = 3

class ContactForm(forms.Form):
    name = forms.CharField()
    email = forms.EmailField()

    # Add clean_name method to validate name length
    # Your code here

Need a hint?

Use the clean_name method to validate the name field. Access the value with self.cleaned_data.get('name').

4

Update the view to handle form errors

In your Django view function called contact_view, create an instance of ContactForm with request.POST. Check if the form is valid using form.is_valid(). If not valid, pass the form instance to the template context so errors can be displayed.

Django

from django import forms

MIN_NAME_LENGTH = 3

class ContactForm(forms.Form):
    name = forms.CharField()
    email = forms.EmailField()

    def clean_name(self):
        name = self.cleaned_data.get('name')
        if len(name) < MIN_NAME_LENGTH:
            raise forms.ValidationError('Name must be at least 3 characters long.')
        return name

from django.shortcuts import render

def contact_view(request):
    if request.method == 'POST':
        form = ContactForm(request.POST)
        if form.is_valid():
            # Process valid data here
            pass
        else:
            # Pass form with errors to template
            # Your code here
            pass
    else:
        form = ContactForm()
    return render(request, 'contact.html', {'form': form})

Need a hint?

Use form.is_valid() to check the form. If invalid, return the template with the form instance to show errors.