Djangoフォーム入門｜forms.Form と ModelForm の違いを初心者向けにやさしく解説

1. Djangoのフォーム処理とは何か

1. Djangoのフォーム処理とは何か

Djangoのフォーム処理とは、画面に入力欄を表示し、ユーザーが入力した内容を受け取って確認する仕組みです。例えば、名前やメールアドレスを書く申込書を、パソコン画面で扱えるようにしたものがフォームです。

Djangoでは、このフォーム作成と入力チェックを自動で助けてくれる機能があります。これにより、プログラミング初心者でも安全で正確な入力画面を作れます。

2. forms.Form の基本的な考え方

2. forms.Form の基本的な考え方

forms.Form は、紙のアンケート用紙を自分で設計するイメージです。質問項目を一つずつ自分で決めて作ります。データベースと直接つながらないため、簡単なお問い合わせフォームなどに向いています。

from django import forms

class ContactForm(forms.Form):
    name = forms.CharField(label="名前")
    email = forms.EmailField(label="メールアドレス")
    message = forms.CharField(label="内容")

3. ModelForm の基本的な考え方

3. ModelForm の基本的な考え方

ModelForm は、すでにあるデータベースの設計図をそのまま申込書にするイメージです。Djangoのモデルと連動して、自動的に入力欄を作ってくれます。

「モデル」とは、データを保存する箱の設計図のことです。名前や年齢など、何を保存するかを決めたものです。

from django import forms
from .models import UserProfile

class UserProfileForm(forms.ModelForm):
    class Meta:
        model = UserProfile
        fields = ["name", "age"]

4. forms.Form と ModelForm の違い

4. forms.Form と ModelForm の違い

forms.Form は自由に書けるノート、ModelForm は決まった書式の申請書のような違いがあります。データベースを使わない場合は forms.Form、保存したい場合は ModelForm が便利です。

Djangoフォームの違いを理解することで、どの場面でどちらを使うべきか判断できるようになります。

5. ビューでのフォーム処理の流れ

5. ビューでのフォーム処理の流れ

ビューとは、入力を受け取って処理する担当者のような存在です。フォームを表示し、ボタンが押されたら内容を確認します。

from django.shortcuts import render
from .forms import ContactForm

def contact_view(request):
    form = ContactForm(request.POST or None)
    if form.is_valid():
        print(form.cleaned_data)
    return render(request, "contact.html", {"form": form})

6. テンプレートでフォームを表示する

6. テンプレートでフォームを表示する

テンプレートは、画面の見た目を作る場所です。Djangoフォームは、たった一行で入力欄をまとめて表示できます。

<form method="post">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">送信</button>
</form>

7. 初心者がつまずきやすいポイント

7. 初心者がつまずきやすいポイント

Djangoフォーム初心者がよく困るのは、入力チェックやエラー表示です。Djangoは自動で「正しくない入力」を教えてくれるため、難しい処理を書かなくても安心です。

forms.Form と ModelForm の役割を理解することで、Djangoのフォーム処理全体がぐっと分かりやすくなります。