djangoのformとmodelformの違いを教えてほしい

Question

djangoのformとmodelformの使い分けが分かりません。
formは単にユーザーに値を入力させたいときに用い、modelformはそれをmodelのオブジェクトとしてデータベースに格納する際に用いるのでしょうか？
初心者にもわかりやすく教えていただきたいです。

Answer 1

DjangoのFormは、少々複雑なので、イメージが難しい所ですね(;'∀')

通常のFormでは、Fieldを自ら定義しなければなりませんが、ModelFormは連携するModelをもとにFieldが定義されます。

Formというと、HTMLのFormを再現するものというイメージが強いと思います。
その部分は、あくまでDjangoのForm（ModelForm）の役目の一つです。
テンプレートタグで、いろいろ展開する部分が、これですね。

Djangoでは、サーバーサイド側のバリデーションにもForm（ModelForm）が利用されます。
（汎用ビューを利用すると、そのあたりの仕組みが見えなくてイメージしにくいですが・・・）

サーバーサイドで、バリデーションを行う場合、Postで送られてきたデータをもとに、**Form（ModelForm）インスタンスを再度生成（←イメージしにくい部分です）**します。これを、データが結びつけられたフォーム（bound form）と呼びます。

bound formの場合、Formでは、バリデーションの実行(is_valid()の実行)と、バリデーションが正常に終われば、クリーニングされたデータ（cleaned_data）を取り出せますが、ModelFormでは、それに加えて、Modelに直接save()することができます。

単一のモデルに関するFormを作るのであれば、ModelFormが便利だと思います。

入力された値を、複数のモデルに分けて保存したり、何らかの計算・加工して保存する必要があるのであれば、Formでデータをクリーニングし、そのデータをもとに、それぞれのモデルに書き込む処理を実装するような感じになります。

イメージわきますでしょうか？？

Comments

[wowow]

かなりはっきりしてきました。
現在自分は、モデルに保存されたデータをユーザーが絞り込み検索する機能を実装しようとしているのですが、その際にモデルの持つタグfieldやカテゴリーfieldで絞り込み、ユーザーに返したいと思っています。
この場合だとユーザーからのフォームデータをsaveする必要はないのでFormを使うということになりそうですが、その際にモデルの持つtagやcategoryの中身をフィールドに使ってやるにはどうすればいいのでしょうか？

[Meganezaru]

いろんなアプローチがあると思いますが・・・

Postされた結果（ユーザーが選択したタグ）をもとに、実際のクエリーを実行すればよいのであれば、FormのFieldでタグの値なり、タグに対応したIDなりを取り出せればいいということですよね？

モデルに関連付けなくても、ChoicFieldの選択値をモデルから動的に作成するようなイメージで処理できるように思いますが、どうでしょう？

[wowow]

つまりsample_model.objects.all()みたいな手法でChoiceFieldの選択肢を動的に生成すればいいということでしょうか？
そんな方法思いつきもしませんでした。勉強になります。

[Meganezaru]

そんなイメージですね。
Formインスタンスを生成するときに、引数として渡して、__init__でchoicesにセットするようなアイデアが、多いようです。

[wowow]

見つけました。こういう方法があったとは。
ありがとうございました。

サンプルコード
class SearchForm(forms.Form):

author = forms.MultipleChoiceField(label='著者', widget=forms.CheckboxSelectMultiple, required=False)

def __init__(self, param):
forms.Form.__init__(self, param)
self.fields['author'].choices = [(author.id, author.name) for author in Author.objects.all()]

[cest-bien]

この場合だと、ModelChoiceFieldの指定でもよさそうですね。
ただ、タプルの（IDでなく）Valueの方を自由にカスタマイズするなら、Wowowさんのやり方がいろいろ自由にできそうです。