Form fields and widgets in Django - Mini Project: Build & Apply

Form fields and widgets

📖 Scenario: You are building a simple Django web app to collect user feedback. You want to create a form that asks for the user's name, email, and a message. You will use Django's form fields and widgets to make the form user-friendly.

🎯 Goal: Create a Django form class called FeedbackForm with three fields: name, email, and message. Use appropriate form fields and widgets to make the form easy to use.

📋 What You'll Learn

Create a Django form class named FeedbackForm

Add a name field using CharField with a maximum length of 100

Add an email field using EmailField

Add a message field using CharField with a Textarea widget

Use the forms module from Django

💡 Why This Matters

🌍 Real World

Forms are used in web apps to collect user input like feedback, registrations, or contact info.

💼 Career

Knowing how to create and customize Django forms is essential for backend web developers working with user input.

1

Create the form class and import forms

Import forms from django and create a form class called FeedbackForm that inherits from forms.Form.

Django

from django import forms

# Create the FeedbackForm class here
# Your code here

Hint

Use from django import forms to import the forms module. Then define class FeedbackForm(forms.Form): to start your form.

2

Add the name and email fields

Inside the FeedbackForm class, add a name field using forms.CharField with max_length=100. Also add an email field using forms.EmailField.

Django

from django import forms

class FeedbackForm(forms.Form):
    # Add name field here
    # Add email field here
    # Your code here

Hint

Use name = forms.CharField(max_length=100) and email = forms.EmailField() inside the form class.

3

Add the message field with Textarea widget

Add a message field to FeedbackForm using forms.CharField with the widget=forms.Textarea argument.

Django

from django import forms

class FeedbackForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()
    # Add message field with Textarea widget here
    # Your code here

Hint

Use message = forms.CharField(widget=forms.Textarea) to add a multi-line text input.

4

Add a label to the message field

Add a label argument to the message field with the value 'Your Feedback' to make the form clearer.

Django

from django import forms

class FeedbackForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()
    message = forms.CharField(widget=forms.Textarea, label='Your Feedback')
    # Your code here

Hint

Add label='Your Feedback' inside the message field definition.

Practice

1. What is the main purpose of a Form field in Django?

easy

A. To define the type of data you want to collect from the user

B. To style the form with CSS classes

C. To handle database queries automatically

D. To create HTML templates for the form

Solution

1. Step 1: Understand the role of form fields

   Form fields specify what kind of data the form expects, like text, numbers, or dates.

2. Step 2: Differentiate from widgets and templates

   Widgets control how the input looks, and templates handle HTML structure, not data type.

3. Final Answer:

   To define the type of data you want to collect from the user -> Option A

4. Quick Check:

   Form field = data type definition [OK]

Hint: Form fields = data type; widgets = appearance [OK]

Common Mistakes:

• Confusing widgets with form fields
• Thinking form fields handle styling
• Assuming form fields manage database queries

2. Which of the following is the correct way to add a placeholder attribute to a Django form field using a widget?

easy

A. forms.CharField(widget=forms.TextInput(placeholder='Enter name'))

B. forms.CharField(placeholder='Enter name')

C. forms.CharField(widget=forms.TextInput(attrs={'placeholder': 'Enter name'}))

D. forms.CharField(attrs={'placeholder': 'Enter name'})

Solution

1. Step 1: Recall widget attribute usage

   In Django, to add HTML attributes like placeholder, you pass them inside the widget's attrs dictionary.

2. Step 2: Check each option's syntax

   forms.CharField(widget=forms.TextInput(attrs={'placeholder': 'Enter name'})) correctly uses widget=forms.TextInput(attrs={'placeholder': 'Enter name'}). Others misuse or omit attrs.

3. Final Answer:

   forms.CharField(widget=forms.TextInput(attrs={'placeholder': 'Enter name'})) -> Option C

4. Quick Check:

   Use attrs dict inside widget for HTML attributes [OK]

Hint: Use attrs dict inside widget to add HTML attributes [OK]

Common Mistakes:

• Passing placeholder directly to CharField
• Omitting attrs dictionary
• Using wrong widget syntax

3. Given the form field declaration below, what HTML input element will be rendered?

email = forms.EmailField(widget=forms.EmailInput(attrs={'class': 'email-field', 'aria-label': 'Email address'}))

medium

A. <input type="text" class="email-field" aria-label="Email address" name="email" required>

B. <input type="email" class="email-field" aria-label="Email address" name="email" required>

C. <textarea class="email-field" aria-label="Email address" name="email" required></textarea>

D. <input type="email" name="email" required>

Solution

1. Step 1: Identify the widget type

   The widget is EmailInput, which renders an input with type="email".

2. Step 2: Check the attributes added

   The attrs dictionary adds class="email-field" and aria-label="Email address" to the input element.

3. Final Answer:

   <input type="email" class="email-field" aria-label="Email address" name="email" required> -> Option B

4. Quick Check:

   EmailField + EmailInput widget = input type email with attrs [OK]

Hint: EmailInput widget renders input type email with given attrs [OK]

Common Mistakes:

• Confusing EmailInput with TextInput
• Ignoring attrs dictionary
• Expecting textarea instead of input

4. What is wrong with this Django form field declaration?

age = forms.IntegerField(widget=forms.TextInput(attrs={'type': 'number'}))

medium

A. Using TextInput widget with IntegerField is incorrect; use NumberInput instead

B. attrs dictionary cannot contain 'type' attribute

C. IntegerField does not accept widgets

D. The syntax is correct and will work as expected

Solution

1. Step 1: Understand widget compatibility

   IntegerField expects a widget that supports numeric input, like NumberInput.

2. Step 2: Analyze the widget used

   Using TextInput with attrs={'type': 'number'} tries to force input type but is not the recommended way and may cause issues.

3. Final Answer:

   Using TextInput widget with IntegerField is incorrect; use NumberInput instead -> Option A

4. Quick Check:

   IntegerField + NumberInput widget is correct combo [OK]

Hint: Use NumberInput widget for IntegerField, not TextInput [OK]

Common Mistakes:

• Forcing input type in attrs instead of using correct widget
• Assuming all widgets work with all fields
• Ignoring widget-field compatibility

5. You want to create a Django form field for a password input that: - Hides the typed characters - Has a placeholder saying 'Enter your password' - Adds a CSS class 'password-input' Which of the following is the correct way to declare this field?

hard

A. password = forms.CharField(widget=forms.PasswordInput(placeholder='Enter your password', class='password-input'))

B. password = forms.PasswordField(widget=forms.TextInput(attrs={'placeholder': 'Enter your password', 'class': 'password-input'}))

C. password = forms.CharField(widget=forms.TextInput(attrs={'placeholder': 'Enter your password', 'class': 'password-input'}))

D. password = forms.CharField(widget=forms.PasswordInput(attrs={'placeholder': 'Enter your password', 'class': 'password-input'}))

Solution

1. Step 1: Choose the correct field and widget

   Password inputs use CharField with PasswordInput widget to hide characters.

2. Step 2: Add attributes correctly

   Attributes like placeholder and class must be inside the attrs dictionary passed to the widget.

3. Step 3: Check each option

   password = forms.CharField(widget=forms.PasswordInput(attrs={'placeholder': 'Enter your password', 'class': 'password-input'})) correctly uses PasswordInput(attrs={...}). password = forms.PasswordField(widget=forms.TextInput(attrs={'placeholder': 'Enter your password', 'class': 'password-input'})) uses non-existent PasswordField. password = forms.CharField(widget=forms.TextInput(attrs={'placeholder': 'Enter your password', 'class': 'password-input'})) uses TextInput which renders type="text" and does not hide characters. password = forms.CharField(widget=forms.PasswordInput(placeholder='Enter your password', class='password-input')) passes attrs incorrectly.

4. Final Answer:

   password = forms.CharField(widget=forms.PasswordInput(attrs={'placeholder': 'Enter your password', 'class': 'password-input'})) -> Option D

5. Quick Check:

   PasswordInput widget + attrs dict = correct password field [OK]

Hint: Use PasswordInput widget with attrs dict for placeholders and classes [OK]

Common Mistakes:

• Using non-existent PasswordField
• Passing attrs outside attrs dictionary
• Using TextInput instead of PasswordInput