{"title":"フォームセット (Formset)","version":"6.0","locale":"ja","docname":"topics/forms/formsets","url":"/ja/6.0/topics/forms/formsets/","canonical":"https://djangodocs.dev/ja/6.0/topics/forms/formsets/","summary":"class BaseFormSet Link to this definition # フォームセットは、同じページで複数のフォームを扱うための抽象レイヤーです。データグリッドに例えるとわかりやすいでしょう。次のようなフォームがあるとしましょう: Python console Copy >>> from django…","html":"

フォームセット (Formset)Link to this heading#

\n
\n
\nclass BaseFormSetLink to this definition#
\n
\n\n

フォームセットは、同じページで複数のフォームを扱うための抽象レイヤーです。データグリッドに例えるとわかりやすいでしょう。次のようなフォームがあるとしましょう:

\n
Python console
>>> from django import forms\n>>> class ArticleForm(forms.Form):\n...     title = forms.CharField()\n...     pub_date = forms.DateField()\n...\n
\n

ユーザーが一度に複数の記事を作成できるようにしたいと思うかもしれません。 ArticleForm からフォームセットを作るには、次のようにします:

\n
Python console
>>> from django.forms import formset_factory\n>>> ArticleFormSet = formset_factory(ArticleForm)\n
\n

これで ArticleFormSet という名前のフォームセットクラスが作成されました。フォームセットをインスタンス化することで、フォームセット内のフォームをイテレートし、通常のフォームと同じように表示できます:

\n
Python console
>>> formset = ArticleFormSet()\n>>> for form in formset:\n...     print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></div>\n
\n

見てのとおり、空のフォームがひとつだけ表示されました。表示される空のフォームの数は extra パラメータで制御できます。デフォルトでは、 formset_factory() は空のフォームを1つ定義します。次の例では、フォームセットクラスを作成して空のフォームを2つ表示します:

\n
Python console
>>> ArticleFormSet = formset_factory(ArticleForm, extra=2)\n
\n

Formsets can be iterated and indexed, accessing forms in the order they were\ncreated. You can reorder the forms by overriding the default\niteration and\nindexing behavior if needed.

\n
\n

フォームセットで初期データを指定するLink to this heading#

\n

初期データはフォームセットの使いやすさを左右します。上で示したように、追加フォームの数を定義できます。これは、フォームセットが初期データから生成するフォームに加え、追加で表示するフォームの数を指定することを意味します。例を見てみましょう:

\n
Python console
>>> import datetime\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, extra=2)\n>>> formset = ArticleFormSet(\n...     initial=[\n...         {\n...             "title": "Django is now open source",\n...             "pub_date": datetime.date.today(),\n...         }\n...     ]\n... )\n\n>>> for form in formset:\n...     print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" value="Django is now open source" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" value="2023-02-11" id="id_form-0-pub_date"></div>\n<div><label for="id_form-1-title">Title:</label><input type="text" name="form-1-title" id="id_form-1-title"></div>\n<div><label for="id_form-1-pub_date">Pub date:</label><input type="text" name="form-1-pub_date" id="id_form-1-pub_date"></div>\n<div><label for="id_form-2-title">Title:</label><input type="text" name="form-2-title" id="id_form-2-title"></div>\n<div><label for="id_form-2-pub_date">Pub date:</label><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></div>\n
\n

上の例では、今度は 3 つのフォームが表示されました。初期データとして渡された 1 つと、2 つの追加フォームです。初期データとして、辞書のリストを渡していることにも注意してください。

\n

フォームセットを描画するために initial を使う場合、フォームセットの送信を処理するときに同じ initial を渡して、どのフォームがユーザによって変更されたかをフォームセットが検出できるようにしてください。例えば、ArticleFormSet(request.POST, initial=[...]) のようになるでしょう。

\n\n
\n
\n

フォームの最大表示数を制限するLink to this heading#

\n

formset_factory() に max_num パラメータを渡すと、フォームセットが表示するフォームの数を制限できます:

\n
Python console
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, extra=2, max_num=1)\n>>> formset = ArticleFormSet()\n>>> for form in formset:\n...     print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></div>\n
\n

もし、max_num の値が初期データ内に存在するオブジェクトの合計より大きい場合、 extra を上限として空のフォームがフォームセットに追加されます。 フォームの合計の長さは max_num を超えることはできません。例えば、extra=2 と max_num=2、そしてフォームセットが 1 つの initial 項目で初期化される場合、この初期項目のフォームと 1 つの空のフォームが表示されます。

\n

初期データ内の項目数が max_num を超える場合、max_num の値に関わらず全ての初期データのフォームが表示され、追加フォームは 1 つも表示されません。例えば、extra=3 と max_num=1、そしてフォームセットが 2 つの初期項目で初期化される場合、2 つのフォームが初期データとともに表示されます。

\n

max_num の値が None (デフォルト) だった場合、表示されるフォームの上限は大きな数になります (1000)。この数は、実際には制限がないと見なせるでしょう。

\n

By default, max_num only affects how many forms are displayed and does not\naffect validation. If validate_max=True is passed to the\nformset_factory(), then max_num will affect\nvalidation. See validate_max.

\n
\n
\n

インスタンス化できるフォームの数を制限するLink to this heading#

\n

formset_factory() の absolute_max パラメータによって、 POST データを与えたときにインスタンス化できるフォームの数を制限できます。これにより、偽造された POST リクエストを使用したメモリ枯渇攻撃から守ることができます:

\n
Python console
>>> from django.forms.formsets import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, absolute_max=1500)\n>>> data = {\n...     "form-TOTAL_FORMS": "1501",\n...     "form-INITIAL_FORMS": "0",\n... }\n>>> formset = ArticleFormSet(data)\n>>> len(formset.forms)\n1500\n>>> formset.is_valid()\nFalse\n>>> formset.non_form_errors()\n['Please submit at most 1000 forms.']\n
\n

absolute_max が None の場合、デフォルトは max_num + 1000 になります (max_num が None の場合、デフォルトは 2000 になります)。

\n

absolute_max が max_num よりも小さい場合、 ValueError が発生します。

\n
\n
\n

フォームセットのバリデーションLink to this heading#

\n

フォームセットでのバリデーションは通常の Form とほとんど同じです。フォームセットには便利な is_valid メソッドがあり、フォームセット内のすべてのフォームを検証できます:

\n
Python console
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm)\n>>> data = {\n...     "form-TOTAL_FORMS": "1",\n...     "form-INITIAL_FORMS": "0",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nTrue\n
\n

フォームセットに何もデータを渡さなかったので、有効なフォームとみなされます。フォームセットは十分に賢いので、変更されていない余分なフォームは無視します。無効な記事を提供すると、:

\n
Python console
>>> data = {\n...     "form-TOTAL_FORMS": "2",\n...     "form-INITIAL_FORMS": "0",\n...     "form-0-title": "Test",\n...     "form-0-pub_date": "1904-06-16",\n...     "form-1-title": "Test",\n...     "form-1-pub_date": "",  # <-- this date is missing but required\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {'pub_date': ['This field is required.']}]\n
\n

見て分かるように、 formset.errors はリストで、 そのエントリーはフォームセット内のフォームと一致します。 バリデーションは、2 つのフォームそれぞれに働いて、2 つ目の項目にエラーメッセージが表示されています。

\n

通常の Form を使うときとまったく同じように、フォームセットのフォーム内のそれぞれのフィールドは、ブラウザのバリデーションのための maxlength のような HTML 属性を含むことができます。ただし、フォームセットのフォームフィールドは、required 属性を含みません。これは、フォームを追加したり削除するときにバリデーションが正しく働かない可能性があるためです。

\n
\n
\nBaseFormSet.total_error_count()Link to this definition#
\n
\n\n

フォームセット内のエラーの数を確認するには、 total_error_count メソッドを使用します:

\n
Python console
>>> # Using the previous example\n>>> formset.errors\n[{}, {'pub_date': ['This field is required.']}]\n>>> len(formset.errors)\n2\n>>> formset.total_error_count()\n1\n
\n

また、フォームのデータが初期データと異なるかどうか（つまり、フォームがデータなしで送信されたかどうか）もチェックできます:

\n
Python console
>>> data = {\n...     "form-TOTAL_FORMS": "1",\n...     "form-INITIAL_FORMS": "0",\n...     "form-0-title": "",\n...     "form-0-pub_date": "",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.has_changed()\nFalse\n
\n
\n

ManagementForm を理解するLink to this heading#

\n

上のフォームセットのデータに追加のデータ (form-TOTAL_FORMS, form-INITIAL_FORMS) が必要なことに気づいたかもしれません。このデータは ManagementForm に必要です。このフォームは、フォームセットに含まれるフォームのコレクションを管理するために使用されます。この管理データを渡さないと、フォームセットは無効になります:

\n
Python console
>>> data = {\n...     "form-0-title": "Test",\n...     "form-0-pub_date": "",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n
\n

これは、表示されているフォームインスタンスの数を追跡するために使用されます。 JavaScriptを使用して新しいフォームを追加する場合は、フォームのカウントフィールドもインクリメントする必要があります。 一方、既存のオブジェクトの削除を許可するためにJavaScriptを使用している場合は、POST データに form-#-DELETE を含めることで、削除対象のマークが適切に削除されていることを確認する必要があります。 すべてのフォームがそれにかかわらず POST データに存在することが期待されます。

\n

ManagementFormは、フォームセット自体の属性として使用できます。 テンプレートでフォームセットをレンダリングするときは、{{ my_formset.management_form }} (my_formsetは適切な名前に置き換えます)をレンダリングすることで、すべての管理データを含めることができます。

\n\n
\n
\n

total_form_count と initial_form_countLink to this heading#

\n

BaseFormSet には、ManagementForm、total_form_count、initial_form_count と密接に関わる 2 つのメソッドがあります。

\n

total_form_count は、対象のフィールドセット内のフォームの合計数を返します。initial_form_count は、記入前のフォームセット内のフォームの数を返し、またいくつのフォームが必須なのかを決めるためにも使われます。通常、これらのメソッドをオーバーライドする必要はありませんが、もし必要な場合はメソッドの動作を理解してからオーバーライドしてください。

\n
\n
\n

empty_formLink to this heading#

\n

BaseFormSet には追加の属性 empty_form があり、__prefix__ というプレフィックスとともにフォームのインスタンスを返します。これにより、JavaScript で動的にフォームを操作することが容易となります。

\n
\n
\n

error_messagesLink to this heading#

\n

引数 error_messages で、フォームセットが表示するデフォルトのメッセージを上書きできます。上書きしたいエラーメッセージにマッチするキーを持つ辞書を渡します。エラーメッセージのキーには 'too_few_forms', 'too_many_forms', 'missing_management_form' があります。 too_few_forms' と too_many_forms' のエラーメッセージには %(num)d を含めることができ、それぞれ min_num と max_num に置き換えられます。

\n

例えば、管理フォームがない場合のデフォルトのエラーメッセージは以下の通りです:

\n
Python console
>>> formset = ArticleFormSet({})\n>>> formset.is_valid()\nFalse\n>>> formset.non_form_errors()\n['ManagementForm data is missing or has been tampered with. Missing fields: form-TOTAL_FORMS, form-INITIAL_FORMS. You may need to file a bug report if the issue persists.']\n
\n

そしてこれはカスタムエラーメッセージです:

\n
Python console
>>> formset = ArticleFormSet(\n...     {}, error_messages={"missing_management_form": "Sorry, something went wrong."}\n... )\n>>> formset.is_valid()\nFalse\n>>> formset.non_form_errors()\n['Sorry, something went wrong.']\n
\n
\n
\n

フォームセットのバリデーションをカスタマイズするLink to this heading#

\n

フォームセットには Form クラスと同じような clean メソッドがあります。ここで、フォームセットレベルで動作する独自のバリデーションを定義します:

\n
Python console
>>> from django.core.exceptions import ValidationError\n>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n\n>>> class BaseArticleFormSet(BaseFormSet):\n...     def clean(self):\n...         """Checks that no two articles have the same title."""\n...         if any(self.errors):\n...             # Don't bother validating the formset unless each form is valid on its own\n...             return\n...         titles = set()\n...         for form in self.forms:\n...             if self.can_delete and self._should_delete_form(form):\n...                 continue\n...             title = form.cleaned_data.get("title")\n...             if title in titles:\n...                 raise ValidationError("Articles in a set must have distinct titles.")\n...             titles.add(title)\n...\n\n>>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet)\n>>> data = {\n...     "form-TOTAL_FORMS": "2",\n...     "form-INITIAL_FORMS": "0",\n...     "form-0-title": "Test",\n...     "form-0-pub_date": "1904-06-16",\n...     "form-1-title": "Test",\n...     "form-1-pub_date": "1912-06-23",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {}]\n>>> formset.non_form_errors()\n['Articles in a set must have distinct titles.']\n
\n

フォームセットの clean メソッドは、Form.clean メソッドが呼ばれた後に呼び出されます。エラーを取得するには、フォームセットの non_form_errors() メソッドを使います。

\n

フォーム以外のエラーは、フォーム固有のエラーと区別するために nonform という追加のクラスでレンダリングされます。たとえば、 {{ formset.non_form_errors }} は次のようになります:

\n
Django template
<ul class="errorlist nonform">\n    <li>Articles in a set must have distinct titles.</li>\n</ul>\n
\n
\n
\n
\n

フォームセット内のフォームの数を検証するLink to this heading#

\n

送信されたフォームの最小および最大数を検証するために、Django にはいくつかの方法が用意されています。フォームの数のバリデーションをさらにカスタマイズする必要があるときは、カスタムのフォームセットバリデーションを使用する必要があります。

\n
\n

validate_maxLink to this heading#

\n

formset_factory() に validate_max=True が渡された場合、データセット内のフォーム数から削除マークが付けられたフォーム数を除いた数が max_num 以下であるかどうかも検証されます。

\n
Python console
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, max_num=1, validate_max=True)\n>>> data = {\n...     "form-TOTAL_FORMS": "2",\n...     "form-INITIAL_FORMS": "0",\n...     "form-0-title": "Test",\n...     "form-0-pub_date": "1904-06-16",\n...     "form-1-title": "Test 2",\n...     "form-1-pub_date": "1912-06-23",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {}]\n>>> formset.non_form_errors()\n['Please submit at most 1 form.']\n
\n

validate_max=True は max_num に対して厳密にバリデーションを行います。たとえ max_num を超過した原因が初期データの量が多すぎたことだったとしてもです。

\n

エラーメッセージは error_messages 引数に 'too_many_forms' メッセージを渡すことでカスタマイズできます。

\n\n
\n
\n

validate_minLink to this heading#

\n

formset_factory() に validate_min=True が渡された場合、バリデーションはデータセット内のフォームの数から削除マークが付けられたものを除いた数が min_num 以上であることもチェックします。

\n
Python console
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, min_num=3, validate_min=True)\n>>> data = {\n...     "form-TOTAL_FORMS": "2",\n...     "form-INITIAL_FORMS": "0",\n...     "form-0-title": "Test",\n...     "form-0-pub_date": "1904-06-16",\n...     "form-1-title": "Test 2",\n...     "form-1-pub_date": "1912-06-23",\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nFalse\n>>> formset.errors\n[{}, {}]\n>>> formset.non_form_errors()\n['Please submit at least 3 forms.']\n
\n

エラーメッセージは error_messages 引数に 'too_few_forms' メッセージを渡すことでカスタマイズできます。

\n\n
\n
\n
\n

フォームのソートと削除に対応させるLink to this heading#

\n

formset_factory() には、フォームセット内のフォームの順序およびフォームセットからのフォームの削除に役立つ 2 つのオプション引数があります。

\n
\n

can_orderLink to this heading#

\n
\n
\nBaseFormSet.can_orderLink to this definition#
\n
\n\n

デフォルト値: False

\n

下記のように、ソート可能なフォームセットを作成できます:

\n
Python console
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, can_order=True)\n>>> formset = ArticleFormSet(\n...     initial=[\n...         {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n...         {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n...     ]\n... )\n>>> for form in formset:\n...     print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" value="Article #1" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" value="2008-05-10" id="id_form-0-pub_date"></div>\n<div><label for="id_form-0-ORDER">Order:</label><input type="number" name="form-0-ORDER" value="1" id="id_form-0-ORDER"></div>\n<div><label for="id_form-1-title">Title:</label><input type="text" name="form-1-title" value="Article #2" id="id_form-1-title"></div>\n<div><label for="id_form-1-pub_date">Pub date:</label><input type="text" name="form-1-pub_date" value="2008-05-11" id="id_form-1-pub_date"></div>\n<div><label for="id_form-1-ORDER">Order:</label><input type="number" name="form-1-ORDER" value="2" id="id_form-1-ORDER"></div>\n<div><label for="id_form-2-title">Title:</label><input type="text" name="form-2-title" id="id_form-2-title"></div>\n<div><label for="id_form-2-pub_date">Pub date:</label><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></div>\n<div><label for="id_form-2-ORDER">Order:</label><input type="number" name="form-2-ORDER" id="id_form-2-ORDER"></div>\n
\n

これで、各フォームにフィールドが追加されます。この新しいフィールドは ORDER という名前で、forms.IntegerField です。初期データのフォームには自動的に数値が割り当てられます。ユーザーがこれらの値を変更すると何が起こるかを見てみましょう:

\n
Python console
>>> data = {\n...     "form-TOTAL_FORMS": "3",\n...     "form-INITIAL_FORMS": "2",\n...     "form-0-title": "Article #1",\n...     "form-0-pub_date": "2008-05-10",\n...     "form-0-ORDER": "2",\n...     "form-1-title": "Article #2",\n...     "form-1-pub_date": "2008-05-11",\n...     "form-1-ORDER": "1",\n...     "form-2-title": "Article #3",\n...     "form-2-pub_date": "2008-05-01",\n...     "form-2-ORDER": "0",\n... }\n\n>>> formset = ArticleFormSet(\n...     data,\n...     initial=[\n...         {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n...         {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n...     ],\n... )\n>>> for form in formset.ordered_forms:\n...     print(form.cleaned_data)\n...\n{'title': 'Article #3', 'pub_date': datetime.date(2008, 5, 1), 'ORDER': 0}\n{'title': 'Article #2', 'pub_date': datetime.date(2008, 5, 11), 'ORDER': 1}\n{'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10), 'ORDER': 2}\n
\n

BaseFormSet には ordering_widget 属性と get_ordering_widget() メソッドがあり、 can_order で使用するウィジェットを制御します。

\n
\n

ordering_widgetLink to this heading#

\n
\n
\nBaseFormSet.ordering_widgetLink to this definition#
\n
\n\n

デフォルト値: NumberInput

\n

ordering_widget をセットすると、 can_order で使用するウィジェットクラスを指定できます:

\n
Python console
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n...     ordering_widget = HiddenInput\n...\n\n>>> ArticleFormSet = formset_factory(\n...     ArticleForm, formset=BaseArticleFormSet, can_order=True\n... )\n
\n
\n
\n

get_ordering_widgetLink to this heading#

\n
\n
\nBaseFormSet.get_ordering_widget()Link to this definition#
\n
\n\n

can_order で使用するウィジェットのインスタンスを指定する必要がある場合は、 get_ordering_widget() をオーバーライドします:

\n
Python console
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n...     def get_ordering_widget(self):\n...         return HiddenInput(attrs={"class": "ordering"})\n...\n\n>>> ArticleFormSet = formset_factory(\n...     ArticleForm, formset=BaseArticleFormSet, can_order=True\n... )\n
\n
\n
\n
\n

can_deleteLink to this heading#

\n
\n
\nBaseFormSet.can_deleteLink to this definition#
\n
\n\n

デフォルト値: False

\n

削除するフォームを選択できるフォームセットを作成できます:

\n
Python console
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, can_delete=True)\n>>> formset = ArticleFormSet(\n...     initial=[\n...         {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n...         {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n...     ]\n... )\n>>> for form in formset:\n...     print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" value="Article #1" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" value="2008-05-10" id="id_form-0-pub_date"></div>\n<div><label for="id_form-0-DELETE">Delete:</label><input type="checkbox" name="form-0-DELETE" id="id_form-0-DELETE"></div>\n<div><label for="id_form-1-title">Title:</label><input type="text" name="form-1-title" value="Article #2" id="id_form-1-title"></div>\n<div><label for="id_form-1-pub_date">Pub date:</label><input type="text" name="form-1-pub_date" value="2008-05-11" id="id_form-1-pub_date"></div>\n<div><label for="id_form-1-DELETE">Delete:</label><input type="checkbox" name="form-1-DELETE" id="id_form-1-DELETE"></div>\n<div><label for="id_form-2-title">Title:</label><input type="text" name="form-2-title" id="id_form-2-title"></div>\n<div><label for="id_form-2-pub_date">Pub date:</label><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></div>\n<div><label for="id_form-2-DELETE">Delete:</label><input type="checkbox" name="form-2-DELETE" id="id_form-2-DELETE"></div>\n
\n

can_order と同様に、各フォームに DELETE という名前の新しいフィールドが追加されます。このフィールドは forms.BooleanField です。削除フィールドのいずれかをマークしてデータが渡されると、それらに deleted_forms でアクセスできます。

\n
Python console
>>> data = {\n...     "form-TOTAL_FORMS": "3",\n...     "form-INITIAL_FORMS": "2",\n...     "form-0-title": "Article #1",\n...     "form-0-pub_date": "2008-05-10",\n...     "form-0-DELETE": "on",\n...     "form-1-title": "Article #2",\n...     "form-1-pub_date": "2008-05-11",\n...     "form-1-DELETE": "",\n...     "form-2-title": "",\n...     "form-2-pub_date": "",\n...     "form-2-DELETE": "",\n... }\n\n>>> formset = ArticleFormSet(\n...     data,\n...     initial=[\n...         {"title": "Article #1", "pub_date": datetime.date(2008, 5, 10)},\n...         {"title": "Article #2", "pub_date": datetime.date(2008, 5, 11)},\n...     ],\n... )\n>>> [form.cleaned_data for form in formset.deleted_forms]\n[{'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10), 'DELETE': True}]\n
\n

ModelFormSet を使っている場合、 formset.save() を呼び出すと、削除されたフォームのモデルインスタンスは削除されます。

\n

If you call formset.save(commit=False), objects will not be deleted\nautomatically. You'll need to call delete() on each of the\nformset.deleted_objects to actually delete\nthem:

\n
Python console
>>> instances = formset.save(commit=False)\n>>> for obj in formset.deleted_objects:\n...     obj.delete()\n...\n
\n

一方、普通の FormSet を使用している場合は、フォームを削除するという一般的な概念がないため、あなた自身でフォームセットの save() メソッドで formset.deleted_forms を処理することになります。

\n

BaseFormSet には deletion_widget 属性と get_deletion_widget() メソッドもあり、 can_delete で使用するウィジェットを制御します。

\n
\n

deletion_widgetLink to this heading#

\n
\n
\nBaseFormSet.deletion_widgetLink to this definition#
\n
\n\n

デフォルト値: CheckboxInput

\n

delete_widget をセットすると、 can_delete で使用するウィジェットクラスを指定できます:

\n
Python console
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n...     deletion_widget = HiddenInput\n...\n\n>>> ArticleFormSet = formset_factory(\n...     ArticleForm, formset=BaseArticleFormSet, can_delete=True\n... )\n
\n
\n
\n

get_deletion_widgetLink to this heading#

\n
\n
\nBaseFormSet.get_deletion_widget()Link to this definition#
\n
\n\n

can_delete で使用するウィジェットのインスタンスを指定する必要がある場合は、 get_deletion_widget() をオーバーライドします:

\n
Python console
>>> from django.forms import BaseFormSet, formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n...     def get_deletion_widget(self):\n...         return HiddenInput(attrs={"class": "deletion"})\n...\n\n>>> ArticleFormSet = formset_factory(\n...     ArticleForm, formset=BaseArticleFormSet, can_delete=True\n... )\n
\n
\n
\n
\n

can_delete_extraLink to this heading#

\n
\n
\nBaseFormSet.can_delete_extraLink to this definition#
\n
\n\n

デフォルト値: True

\n

can_delete=True を設定しているときに can_delete_extra=False を指定すると、余分なフォームを削除するオプションがなくなります。

\n
\n
\n
\n

フォームセットにフィールドを追加するLink to this heading#

\n

フォームセットに追加のフィールドを追加する必要がある場合、これは簡単に実現できます。フォームセットの基底クラスには add_fields メソッドがあります。このメソッドをオーバーライドすることで、独自のフィールドを追加したり、 デフォルトのフィールドや属性を再定義したりすることができます:

\n
Python console
>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> class BaseArticleFormSet(BaseFormSet):\n...     def add_fields(self, form, index):\n...         super().add_fields(form, index)\n...         form.fields["my_field"] = forms.CharField()\n...\n\n>>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet)\n>>> formset = ArticleFormSet()\n>>> for form in formset:\n...     print(form)\n...\n<div><label for="id_form-0-title">Title:</label><input type="text" name="form-0-title" id="id_form-0-title"></div>\n<div><label for="id_form-0-pub_date">Pub date:</label><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></div>\n<div><label for="id_form-0-my_field">My field:</label><input type="text" name="form-0-my_field" id="id_form-0-my_field"></div>\n
\n
\n
\n

フォームセットのフォームにカスタムパラメータを渡すLink to this heading#

\n

フォームクラスには、MyArticleForm のようなカスタムパラメータを指定することがあります。フォームセットをインスタンス化するときに、このパラメータを渡すことができます:

\n
Python console
>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n\n>>> class MyArticleForm(ArticleForm):\n...     def __init__(self, *args, user, **kwargs):\n...         self.user = user\n...         super().__init__(*args, **kwargs)\n...\n\n>>> ArticleFormSet = formset_factory(MyArticleForm)\n>>> formset = ArticleFormSet(form_kwargs={"user": request.user})\n
\n

form_kwargs はフォームのインスタンスによって異なります。フォームセットの基底クラスには get_form_kwargs メソッドがあります。このメソッドは引数としてフォームセット内のフォームのインデックスを受け取ります。 empty_form の場合は None です:

\n
Python console
>>> from django.forms import BaseFormSet\n>>> from django.forms import formset_factory\n\n>>> class BaseArticleFormSet(BaseFormSet):\n...     def get_form_kwargs(self, index):\n...         kwargs = super().get_form_kwargs(index)\n...         kwargs["custom_kwarg"] = index\n...         return kwargs\n...\n\n>>> ArticleFormSet = formset_factory(MyArticleForm, formset=BaseArticleFormSet)\n>>> formset = ArticleFormSet()\n
\n
\n
\n

フォームセットのプレフィックスをカスタマイズするLink to this heading#

\n

レンダリングされた HTML では、フォームセットは各フィールド名のプレフィックスを含みます。デフォルトではプレフィックスは 'form' ですが、フォームセットの prefix 引数を使用してカスタマイズすることもできます。

\n

たとえば、デフォルトの場合は次のように表示されます:

\n
Html
<label for="id_form-0-title">Title:</label>\n<input type="text" name="form-0-title" id="id_form-0-title">\n
\n

しかし、ArticleFormset(prefix='article') を使うと、以下のようになります:

\n
Html
<label for="id_article-0-title">Title:</label>\n<input type="text" name="article-0-title" id="id_article-0-title">\n
\n

これは ビュー の中で複数のフォームセットを使いたいときに便利です。

\n
\n
\n

ビューとテンプレートでフォームセットを使うLink to this heading#

\n

フォームセットには、レンダリングに関連する以下の属性とメソッドがあります:

\n
\n
\nBaseFormSet.rendererLink to this definition#
\n

フォームセットに使用する レンダラー を指定します。デフォルトは FORM_RENDERER 設定で指定されたレンダラーです。

\n
\n\n
\n
\nBaseFormSet.template_nameLink to this definition#
\n

print(formset) やテンプレート内で {{ formset }} を使ってフォームセットを文字列にキャストした場合にレンダリングされるテンプレートの名前です。

\n

デフォルトでは、レンダラーの formset_template_name の値を返すプロパティです。テンプレート名に文字列を指定することで、特定のフォームセットクラスのテンプレート名を上書きできます。

\n

このテンプレートは、フォームセットの管理フォームをレンダリングするために使用され、フォームセット内の各フォームは、フォームの template_name で定義されたテンプレートに従ってレンダリングされます。

\n
\n\n
\n
\nBaseFormSet.template_name_divLink to this definition#
\n

as_div() を呼び出す際に使用するテンプレートの名前です。デフォルトでは "django/forms/formsets/div.html" です。このテンプレートはフォームセットの管理フォームをレンダリングし、 フォームセット内の各フォームをフォームの as_div() メソッドに従ってレンダリングします。

\n
\n\n
\n
\nBaseFormSet.template_name_pLink to this definition#
\n

as_p() を呼び出す際に使用するテンプレートの名前です。デフォルトでは "django/forms/formsets/p.html" です。このテンプレートはフォームセットの管理フォームをレンダリングし、 フォームセット内の各フォームをフォームの as_p() メソッドに従ってレンダリングします。

\n
\n\n
\n
\nBaseFormSet.template_name_tableLink to this definition#
\n

as_table() を呼び出す際に使用するテンプレートの名前です。デフォルトでは "django/forms/formsets/table.html" です。このテンプレートはフォームセットの管理フォームをレンダリングし、 フォームセット内の各フォームをフォームの as_table() メソッドに従ってレンダリングします。

\n
\n\n
\n
\nBaseFormSet.template_name_ulLink to this definition#
\n

as_ul() を呼び出す際に使用するテンプレートの名前です。デフォルトでは "django/forms/formsets/ul.html" です。このテンプレートはフォームセットの管理フォームをレンダリングし、 フォームセット内の各フォームをフォームの as_ul() メソッドに従ってレンダリングします。

\n
\n\n
\n
\nBaseFormSet.get_context()Link to this definition#
\n

テンプレート内のフォームセットをレンダリングするためのコンテキストを返します。

\n

利用可能なコンテキストは次のとおりです。

\n
    \n

  • formset: フォームセットのインスタンス。

    • \n
\n
\n\n
\n
\nBaseFormSet.render(template_name=None, context=None, renderer=None)Link to this definition#
\n

render メソッドは str__ メソッド、 as_div() メソッド、 as_p() メソッド、 as_ul() メソッド、 as_table() メソッドから呼び出されます。すべての引数は省略可能で、デフォルトは下記です:

\n\n
\n\n
\n
\nBaseFormSet.as_div()Link to this definition#
\n

フォームセットを template_name_div テンプレートでレンダリングします。

\n
\n\n
\n
\nBaseFormSet.as_p()Link to this definition#
\n

フォームセットを template_name_p テンプレートでレンダリングします。

\n
\n\n
\n
\nBaseFormSet.as_table()Link to this definition#
\n

フォームセットを template_name_table テンプレートでレンダリングします。

\n
\n\n
\n
\nBaseFormSet.as_ul()Link to this definition#
\n

フォームセットを template_name_ul テンプレートでレンダリングします。

\n
\n\n

ビュー内でフォームセットを使用するのは、通常の Form クラスを使用するのとあまり変わりません。ただひとつだけ注意したいのが、テンプレート内で管理フォームを使用することです。ビューのサンプルを見てみましょう:

\n
Code
from django.forms import formset_factory\nfrom django.shortcuts import render\nfrom myapp.forms import ArticleForm\n\n\ndef manage_articles(request):\n    ArticleFormSet = formset_factory(ArticleForm)\n    if request.method == "POST":\n        formset = ArticleFormSet(request.POST, request.FILES)\n        if formset.is_valid():\n            # do something with the formset.cleaned_data\n            pass\n    else:\n        formset = ArticleFormSet()\n    return render(request, "manage_articles.html", {"formset": formset})\n
\n

manage_articles.html テンプレートは次のようになります:

\n
Django template
<form method="post">\n    {{ formset.management_form }}\n    <table>\n        {% for form in formset %}\n        {{ form }}\n        {% endfor %}\n    </table>\n</form>\n
\n

ただし、フォームセット自体が管理フォームを処理するためのちょっとしたショートカットもあります。

\n
Django template
<form method="post">\n    <table>\n        {{ formset }}\n    </table>\n</form>\n
\n

上記は、フォームセットクラスで BaseFormSet.render() メソッドを呼び出すことになります。これにより、template_name 属性で指定されたテンプレートを使用してフォームセットがレンダリングされます。フォームと同様に、デフォルトではフォームセットは as_div としてレンダリングされ、その他にも as_p, as_ul, as_table などの補助メソッドが使用可能です。フォームセットのレンダリングは、template_name 属性を指定することでカスタマイズできます。また、より一般的には デフォルトのテンプレートのオーバーライド によってカスタマイズできます。

\n
\n

can_delete や can_order のときに手動でレンダリングするLink to this heading#

\n

テンプレート内で手動でフィールドをレンダリングする場合、 can_delete パラメータを {{ form.DELETE }} でレンダリングできます:

\n
Django template
<form method="post">\n    {{ formset.management_form }}\n    {% for form in formset %}\n        <ul>\n            <li>{{ form.title }}</li>\n            <li>{{ form.pub_date }}</li>\n            {% if formset.can_delete %}\n                <li>{{ form.DELETE }}</li>\n            {% endif %}\n        </ul>\n    {% endfor %}\n</form>\n
\n

同様に、フォームセットに並び替えの機能 (can_order=True) がある場合, {{ form.ORDER }} でレンダリングできます。

\n
\n
\n

ビューで複数のフォームセットを使うLink to this heading#

\n

必要に応じて、1 つのビューで複数のフォームセットを使用できます。フォームセットはその動作の多くをフォームから借用しています。そのため、prefix を使用して、フォームセットのフォームフィールド名の前に指定した値を付与することで、 名前の衝突を避けて複数のフォームセットをビューに送信できます。これをどのように実現するか見てみましょう:

\n
Code
from django.forms import formset_factory\nfrom django.shortcuts import render\nfrom myapp.forms import ArticleForm, BookForm\n\n\ndef manage_articles(request):\n    ArticleFormSet = formset_factory(ArticleForm)\n    BookFormSet = formset_factory(BookForm)\n    if request.method == "POST":\n        article_formset = ArticleFormSet(request.POST, request.FILES, prefix="articles")\n        book_formset = BookFormSet(request.POST, request.FILES, prefix="books")\n        if article_formset.is_valid() and book_formset.is_valid():\n            # do something with the cleaned_data on the formsets.\n            pass\n    else:\n        article_formset = ArticleFormSet(prefix="articles")\n        book_formset = BookFormSet(prefix="books")\n    return render(\n        request,\n        "manage_articles.html",\n        {\n            "article_formset": article_formset,\n            "book_formset": book_formset,\n        },\n    )\n
\n

フォームセットは通常どおりレンダリングされます。ここで重要なのは、POST の場合とそうでない場合の両方で prefix を渡す必要があるということです。

\n

各フォームセットの prefix は、各フィールドの name と id の HTML 属性に追加されるデフォルトの form プレフィックスを置き換えます。

\n
\n
","rootId":"formsets","toc":[{"title":"フォームセットで初期データを指定する","anchor":"using-initial-data-with-a-formset","children":[]},{"title":"フォームの最大表示数を制限する","anchor":"limiting-the-maximum-number-of-forms","children":[]},{"title":"インスタンス化できるフォームの数を制限する","anchor":"limiting-the-maximum-number-of-instantiated-forms","children":[]},{"title":"フォームセットのバリデーション","anchor":"formset-validation","children":[{"title":"ManagementForm を理解する","anchor":"understanding-the-managementform","children":[]},{"title":"total_form_count と initial_form_count","anchor":"total-form-count-and-initial-form-count","children":[]},{"title":"empty_form","anchor":"empty-form","children":[]},{"title":"error_messages","anchor":"error-messages","children":[]},{"title":"フォームセットのバリデーションをカスタマイズする","anchor":"custom-formset-validation","children":[]}]},{"title":"フォームセット内のフォームの数を検証する","anchor":"validating-the-number-of-forms-in-a-formset","children":[{"title":"validate_max","anchor":"validate-max","children":[]},{"title":"validate_min","anchor":"validate-min","children":[]}]},{"title":"フォームのソートと削除に対応させる","anchor":"dealing-with-ordering-and-deletion-of-forms","children":[{"title":"can_order","anchor":"can-order","children":[{"title":"ordering_widget","anchor":"ordering-widget","children":[]},{"title":"get_ordering_widget","anchor":"get-ordering-widget","children":[]}]},{"title":"can_delete","anchor":"can-delete","children":[{"title":"deletion_widget","anchor":"deletion-widget","children":[]},{"title":"get_deletion_widget","anchor":"get-deletion-widget","children":[]}]},{"title":"can_delete_extra","anchor":"can-delete-extra","children":[]}]},{"title":"フォームセットにフィールドを追加する","anchor":"adding-additional-fields-to-a-formset","children":[]},{"title":"フォームセットのフォームにカスタムパラメータを渡す","anchor":"passing-custom-parameters-to-formset-forms","children":[]},{"title":"フォームセットのプレフィックスをカスタマイズする","anchor":"customizing-a-formset-s-prefix","children":[]},{"title":"ビューとテンプレートでフォームセットを使う","anchor":"using-a-formset-in-views-and-templates","children":[{"title":"can_delete や can_order のときに手動でレンダリングする","anchor":"manually-rendered-can-delete-and-can-order","children":[]},{"title":"ビューで複数のフォームセットを使う","anchor":"using-more-than-one-formset-in-a-view","children":[]}]}],"breadcrumbs":[{"docname":"topics/index","title":"Django を使う","url":"/ja/6.0/topics/"},{"docname":"topics/forms/index","title":"フォームを使う","url":"/ja/6.0/topics/forms/"}],"prev":{"docname":"topics/forms/index","title":"フォームを使う","url":"/ja/6.0/topics/forms/"},"next":{"docname":"topics/forms/modelforms","title":"モデルからフォームを作成する","url":"/ja/6.0/topics/forms/modelforms/"},"formats":{"html":"/ja/6.0/topics/forms/formsets/","markdown":"/ja/6.0/topics/forms/formsets.md","json":"/ja/6.0/topics/forms/formsets.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/topics/forms/formsets.txt","official":"https://docs.djangoproject.com/ja/6.0/topics/forms/formsets/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}