{"title":"Formset","version":"3.0","locale":"id","docname":"topics/forms/formsets","url":"/id/3.0/topics/forms/formsets/","canonical":"https://djangodocs.dev/id/3.0/topics/forms/formsets/","summary":"class BaseFormSet Link to this definition # A formset is a layer of abstraction to work with multiple forms on the same page. It can be best compared to a data…","html":"

FormsetLink to this heading#

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

A formset is a layer of abstraction to work with multiple forms on the same\npage. It can be best compared to a data grid. Let's say you have the following\nform:

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

Anda mungkin mengizinkan pengguna membuat beberapa artikel sekaligus. untuk membuat sebuah formset diluar ArticleForm anda akan melakukan:

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

You now have created a formset class named ArticleFormSet.\nInstantiating the formset gives you the ability to iterate over the forms\nin the formset and display them as you would with a regular form:

\n
Code
>>> formset = ArticleFormSet()\n>>> for form in formset:\n...     print(form.as_table())\n<tr><th><label for="id_form-0-title">Title:</label></th><td><input type="text" name="form-0-title" id="id_form-0-title"></td></tr>\n<tr><th><label for="id_form-0-pub_date">Pub date:</label></th><td><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></td></tr>\n
\n

As you can see it only displayed one empty form. The number of empty forms\nthat is displayed is controlled by the extra parameter. By default,\nformset_factory() defines one extra form; the\nfollowing example will create a formset class to display two blank forms:

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

Iterating over a formset will render the forms in the order they were\ncreated. You can change this order by providing an alternate implementation for\nthe __iter__() method.

\n

Formset juga dapat mengindeks, yang mengembalikan formulir sesuai. Jika ada menimpa __iter__, anda akan juga butuh menimpa __getitem__ untuk memiliki perilaku cocok.

\n
\n

Menggunakan data awalan dengan formsetLink to this heading#

\n

Initial data is what drives the main usability of a formset. As shown above\nyou can define the number of extra forms. What this means is that you are\ntelling the formset how many additional forms to show in addition to the\nnumber of forms it generates from the initial data. Let's take a look at an\nexample:

\n
Code
>>> 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(initial=[\n...     {'title': 'Django is now open source',\n...      'pub_date': datetime.date.today(),}\n... ])\n\n>>> for form in formset:\n...     print(form.as_table())\n<tr><th><label for="id_form-0-title">Title:</label></th><td><input type="text" name="form-0-title" value="Django is now open source" id="id_form-0-title"></td></tr>\n<tr><th><label for="id_form-0-pub_date">Pub date:</label></th><td><input type="text" name="form-0-pub_date" value="2008-05-12" id="id_form-0-pub_date"></td></tr>\n<tr><th><label for="id_form-1-title">Title:</label></th><td><input type="text" name="form-1-title" id="id_form-1-title"></td></tr>\n<tr><th><label for="id_form-1-pub_date">Pub date:</label></th><td><input type="text" name="form-1-pub_date" id="id_form-1-pub_date"></td></tr>\n<tr><th><label for="id_form-2-title">Title:</label></th><td><input type="text" name="form-2-title" id="id_form-2-title"></td></tr>\n<tr><th><label for="id_form-2-pub_date">Pub date:</label></th><td><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></td></tr>\n
\n

Sekarang ada jumlah tiga formulir menampilkan diatas. Satu untuk data awalan yang dilewatkan dalam dan dua bentuk formulir tambahan. Juga catat bahwa kami meleeatkan dalam sebuah daftar dictionary sebagai data awalan.

\n

Jika anda menggunakan sebuah initial untuk menampilkan formset, anda harus melewatkan initial sama ketika mengolah pengajuan formset itu sehingga formset dapat mengenali formulir-formulir yang berubah oleh pengguna. Sebagai contoh, anda mungkin memiliki sesuatu seperti: ArticleFormSet(request.POST, initial=[...]).

\n\n
\n
\n

Membatasi nomor maksimal dari formulirLink to this heading#

\n

Parameter max_num pada formset_factory() memberikan anda kemampuan membatasi jumlah formulir formset yang akan dimunculkan:

\n
Code
>>> 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.as_table())\n<tr><th><label for="id_form-0-title">Title:</label></th><td><input type="text" name="form-0-title" id="id_form-0-title"></td></tr>\n<tr><th><label for="id_form-0-pub_date">Pub date:</label></th><td><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></td></tr>\n
\n

If the value of max_num is greater than the number of existing items in the\ninitial data, up to extra additional blank forms will be added to the\nformset, so long as the total number of forms does not exceed max_num. For\nexample, if extra=2 and max_num=2 and the formset is initialized with\none initial item, a form for the initial item and one blank form will be\ndisplayed.

\n

If the number of items in the initial data exceeds max_num, all initial\ndata forms will be displayed regardless of the value of max_num and no\nextra forms will be displayed. For example, if extra=3 and max_num=1\nand the formset is initialized with two initial items, two forms with the\ninitial data will be displayed.

\n

Sebuah nilai max_num dari None (awalan) menaruh batasan tinggi pada sejumlah formulir-formulir ditampilkan (1000). Dalam praktiknya ini adalah setara pada tidak ada batasan.

\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

Pengesahan formsetLink to this heading#

\n

Validation with a formset is almost identical to a regular Form. There is\nan is_valid method on the formset to provide a convenient way to validate\nall forms in the formset:

\n
Code
>>> 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...     'form-MAX_NUM_FORMS': '',\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nTrue\n
\n

We passed in no data to the formset which is resulting in a valid form. The\nformset is smart enough to ignore extra forms that were not changed. If we\nprovide an invalid article:

\n
Code
>>> data = {\n...     'form-TOTAL_FORMS': '2',\n...     'form-INITIAL_FORMS': '0',\n...     'form-MAX_NUM_FORMS': '',\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

As we can see, formset.errors is a list whose entries correspond to the\nforms in the formset. Validation was performed for each of the two forms, and\nthe expected error message appears for the second item.

\n

Just like when using a normal Form, each field in a formset's forms may\ninclude HTML attributes such as maxlength for browser validation. However,\nform fields of formsets won't include the required attribute as that\nvalidation may be incorrect when adding and deleting forms.

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

Untuk memerika seberapa banyak kesalahan ada dalam formset, kami dapat menggunakan metode total_error_count:

\n
Code
>>> # 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

Kami dapat juga memeriksa jika formulir data berbeda dari data awalan (yaitu formulir dikirim tanpa data apapun):

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

Memahami ManagementFormLink to this heading#

\n

You may have noticed the additional data (form-TOTAL_FORMS,\nform-INITIAL_FORMS and form-MAX_NUM_FORMS) that was required\nin the formset's data above. This data is required for the\nManagementForm. This form is used by the formset to manage the\ncollection of forms contained in the formset. If you don't provide\nthis management data, an exception will be raised:

\n
Code
>>> data = {\n...     'form-0-title': 'Test',\n...     'form-0-pub_date': '',\n... }\n>>> formset = ArticleFormSet(data)\n>>> formset.is_valid()\nTraceback (most recent call last):\n...\ndjango.forms.utils.ValidationError: ['ManagementForm data is missing or has been tampered with']\n
\n

It is used to keep track of how many form instances are being displayed. If\nyou are adding new forms via JavaScript, you should increment the count fields\nin this form as well. On the other hand, if you are using JavaScript to allow\ndeletion of existing objects, then you need to ensure the ones being removed\nare properly marked for deletion by including form-#-DELETE in the POST\ndata. It is expected that all forms are present in the POST data regardless.

\n

The management form is available as an attribute of the formset\nitself. When rendering a formset in a template, you can include all\nthe management data by rendering {{ my_formset.management_form }}\n(substituting the name of your formset as appropriate).

\n
\n
\n

total_form_count dan initial_form_countLink to this heading#

\n

BaseFormSet mempunyai sepasang metode yang erat terkait pada ManagementForm, total_form_count dan initial_form_count.

\n

total_form_count returns the total number of forms in this formset.\ninitial_form_count returns the number of forms in the formset that were\npre-filled, and is also used to determine how many forms are required. You\nwill probably never need to override either of these methods, so please be\nsure you understand what they do before doing so.

\n
\n
\n

empty_formLink to this heading#

\n

BaseFormSet provides an additional attribute empty_form which returns\na form instance with a prefix of __prefix__ for easier use in dynamic\nforms with JavaScript.

\n
\n
\n

Penyesuaian pengesahan formsetLink to this heading#

\n

A formset has a clean method similar to the one on a Form class. This\nis where you define your own validation that works at the formset level:

\n
Code
>>> 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 = []\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 forms.ValidationError("Articles in a set must have distinct titles.")\n...             titles.append(title)\n\n>>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet)\n>>> data = {\n...     'form-TOTAL_FORMS': '2',\n...     'form-INITIAL_FORMS': '0',\n...     'form-MAX_NUM_FORMS': '',\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

The formset clean method is called after all the Form.clean methods\nhave been called. The errors will be found using the non_form_errors()\nmethod on the formset.

\n
\n
\n
\n

Mensahkan sejumlah formulir dalam formsetLink to this heading#

\n

Django menyediakan sepasang cara untuk mensahkan angka minimal dan maksimal dari formulir diajukan. Aplikasi yang butuh lebih pengesahan penyesuaian dari sejumlah formulir harus menggunakan pengesahan formset penyesuaian.

\n
\n

validate_maxLink to this heading#

\n

Jika Documentation dilewatkan ke formset_factory(), pengesahan akan juga memeriksa itu sejumlah formulir dalam kumpulan data, dikurangi itu yang ditandai untuk penghapusan, adalah kurang dari atau setara pada max_num.

\n
Code
>>> 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-MIN_NUM_FORMS': '',\n...     'form-MAX_NUM_FORMS': '',\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 1 or fewer forms.']\n
\n

validate_max=True mensahkan terhadap max_num dengan ketat bahkan jika max_num telah melampaui karena sejumlah data pertama disokong telah berlebihan.

\n\n
\n
\n

validate_minLink to this heading#

\n

If validate_min=True is passed to\nformset_factory(), validation will also check\nthat the number of forms in the data set, minus those marked for\ndeletion, is greater than or equal to min_num.

\n
Code
>>> 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-MIN_NUM_FORMS': '',\n...     'form-MAX_NUM_FORMS': '',\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 3 or more forms.']\n
\n
\n
\n
\n

Berurusan dengan pengurutan dan penghapusan formulirLink to this heading#

\n

The formset_factory() provides two optional\nparameters can_order and can_delete to help with ordering of forms in\nformsets and deletion of forms from a formset.

\n
\n

can_orderLink to this heading#

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

Awal: False

\n

Mari anda membuat sebuah formset dengan memampuan mengurutkan:

\n
Code
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, can_order=True)\n>>> formset = ArticleFormSet(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>>> for form in formset:\n...     print(form.as_table())\n<tr><th><label for="id_form-0-title">Title:</label></th><td><input type="text" name="form-0-title" value="Article #1" id="id_form-0-title"></td></tr>\n<tr><th><label for="id_form-0-pub_date">Pub date:</label></th><td><input type="text" name="form-0-pub_date" value="2008-05-10" id="id_form-0-pub_date"></td></tr>\n<tr><th><label for="id_form-0-ORDER">Order:</label></th><td><input type="number" name="form-0-ORDER" value="1" id="id_form-0-ORDER"></td></tr>\n<tr><th><label for="id_form-1-title">Title:</label></th><td><input type="text" name="form-1-title" value="Article #2" id="id_form-1-title"></td></tr>\n<tr><th><label for="id_form-1-pub_date">Pub date:</label></th><td><input type="text" name="form-1-pub_date" value="2008-05-11" id="id_form-1-pub_date"></td></tr>\n<tr><th><label for="id_form-1-ORDER">Order:</label></th><td><input type="number" name="form-1-ORDER" value="2" id="id_form-1-ORDER"></td></tr>\n<tr><th><label for="id_form-2-title">Title:</label></th><td><input type="text" name="form-2-title" id="id_form-2-title"></td></tr>\n<tr><th><label for="id_form-2-pub_date">Pub date:</label></th><td><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></td></tr>\n<tr><th><label for="id_form-2-ORDER">Order:</label></th><td><input type="number" name="form-2-ORDER" id="id_form-2-ORDER"></td></tr>\n
\n

This adds an additional field to each form. This new field is named ORDER\nand is an forms.IntegerField. For the forms that came from the initial\ndata it automatically assigned them a numeric value. Let's look at what will\nhappen when the user changes these values:

\n
Code
>>> data = {\n...     'form-TOTAL_FORMS': '3',\n...     'form-INITIAL_FORMS': '2',\n...     'form-MAX_NUM_FORMS': '',\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(data, 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>>> formset.is_valid()\nTrue\n>>> for form in formset.ordered_forms:\n...     print(form.cleaned_data)\n{'pub_date': datetime.date(2008, 5, 1), 'ORDER': 0, 'title': 'Article #3'}\n{'pub_date': datetime.date(2008, 5, 11), 'ORDER': 1, 'title': 'Article #2'}\n{'pub_date': datetime.date(2008, 5, 10), 'ORDER': 2, 'title': 'Article #1'}\n
\n

BaseFormSet also provides an\nordering_widget attribute and\nget_ordering_widget() method that\ncontrol the widget used with\ncan_order.

\n
\n

ordering_widgetLink to this heading#

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

Awalan: NumberInput

\n

Setel ordering_widget untuk menentukan kelas widget untuk digunakan dengan can_order:

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

get_ordering_widgetLink to this heading#

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

Timpa get_ordering_widget() jika anda butuh menyediakan instance widget untuk digunakan dengan can_order:

\n
Code
>>> 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>>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet, can_order=True)\n
\n
\n
\n
\n

can_deleteLink to this heading#

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

Awal: False

\n

Mari anda membuat sebuah formset dengan kemampuan memilih formulir untuk penghapusan:

\n
Code
>>> from django.forms import formset_factory\n>>> from myapp.forms import ArticleForm\n>>> ArticleFormSet = formset_factory(ArticleForm, can_delete=True)\n>>> formset = ArticleFormSet(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>>> for form in formset:\n...     print(form.as_table())\n<tr><th><label for="id_form-0-title">Title:</label></th><td><input type="text" name="form-0-title" value="Article #1" id="id_form-0-title"></td></tr>\n<tr><th><label for="id_form-0-pub_date">Pub date:</label></th><td><input type="text" name="form-0-pub_date" value="2008-05-10" id="id_form-0-pub_date"></td></tr>\n<tr><th><label for="id_form-0-DELETE">Delete:</label></th><td><input type="checkbox" name="form-0-DELETE" id="id_form-0-DELETE"></td></tr>\n<tr><th><label for="id_form-1-title">Title:</label></th><td><input type="text" name="form-1-title" value="Article #2" id="id_form-1-title"></td></tr>\n<tr><th><label for="id_form-1-pub_date">Pub date:</label></th><td><input type="text" name="form-1-pub_date" value="2008-05-11" id="id_form-1-pub_date"></td></tr>\n<tr><th><label for="id_form-1-DELETE">Delete:</label></th><td><input type="checkbox" name="form-1-DELETE" id="id_form-1-DELETE"></td></tr>\n<tr><th><label for="id_form-2-title">Title:</label></th><td><input type="text" name="form-2-title" id="id_form-2-title"></td></tr>\n<tr><th><label for="id_form-2-pub_date">Pub date:</label></th><td><input type="text" name="form-2-pub_date" id="id_form-2-pub_date"></td></tr>\n<tr><th><label for="id_form-2-DELETE">Delete:</label></th><td><input type="checkbox" name="form-2-DELETE" id="id_form-2-DELETE"></td></tr>\n
\n

Similar to can_order this adds a new field to each form named DELETE\nand is a forms.BooleanField. When data comes through marking any of the\ndelete fields you can access them with deleted_forms:

\n
Code
>>> data = {\n...     'form-TOTAL_FORMS': '3',\n...     'form-INITIAL_FORMS': '2',\n...     'form-MAX_NUM_FORMS': '',\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(data, 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>>> [form.cleaned_data for form in formset.deleted_forms]\n[{'DELETE': True, 'pub_date': datetime.date(2008, 5, 10), 'title': 'Article #1'}]\n
\n

If you are using a ModelFormSet,\nmodel instances for deleted forms will be deleted when you call\nformset.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
Code
>>> instances = formset.save(commit=False)\n>>> for obj in formset.deleted_objects:\n...     obj.delete()\n
\n

On the other hand, if you are using a plain FormSet, it's up to you to\nhandle formset.deleted_forms, perhaps in your formset's save() method,\nas there's no general notion of what it means to delete a form.

\n
\n
\n
\n

Menambahkan bidang-bidang tambahan pada sebuah formsetLink to this heading#

\n

If you need to add additional fields to the formset this can be easily\naccomplished. The formset base class provides an add_fields method. You\ncan override this method to add your own fields or even redefine the default\nfields/attributes of the order and deletion fields:

\n
Code
>>> 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>>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet)\n>>> formset = ArticleFormSet()\n>>> for form in formset:\n...     print(form.as_table())\n<tr><th><label for="id_form-0-title">Title:</label></th><td><input type="text" name="form-0-title" id="id_form-0-title"></td></tr>\n<tr><th><label for="id_form-0-pub_date">Pub date:</label></th><td><input type="text" name="form-0-pub_date" id="id_form-0-pub_date"></td></tr>\n<tr><th><label for="id_form-0-my_field">My field:</label></th><td><input type="text" name="form-0-my_field" id="id_form-0-my_field"></td></tr>\n
\n
\n
\n

Melewatkan parameter penyesuaian pada formulir formsetLink to this heading#

\n

Terkadang kelas formulir anda mengambil parameter penyesuaian, seperti MyArticleForm. Anda dapat melewatkan parameter ini ketika menginstasiasi formset:

\n
Code
>>> 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>>> ArticleFormSet = formset_factory(MyArticleForm)\n>>> formset = ArticleFormSet(form_kwargs={'user': request.user})\n
\n

The form_kwargs may also depend on the specific form instance. The formset\nbase class provides a get_form_kwargs method. The method takes a single\nargument - the index of the form in the formset. The index is None for the\nempty_form:

\n
Code
>>> 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
\n

Menyesuaikan awalan formsetLink to this heading#

\n

In the rendered HTML, formsets include a prefix on each field's name. By\ndefault, the prefix is 'form', but it can be customized using the formset's\nprefix argument.

\n

Sebagai contoh, dalam kasus awalan, anda mungkin melihat:

\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

Tetapi dengan ArticleFormset(prefix='article') yang menjadi:

\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

Ini berguna jika anda ingin use more than one formset in a view.

\n
\n
\n

Menggunakan sebuah formset dalam tampilan dan cetakanLink to this heading#

\n

Using a formset inside a view is not very different from using a regular\nForm class. The only thing you will want to be aware of is making sure to\nuse the management form inside the template. Let's look at a sample view:

\n
Code
from django.forms import formset_factory\nfrom django.shortcuts import render\nfrom myapp.forms import ArticleForm\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

Cetakan manage_articles.html mungkin kelihatan seperti ini:

\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

Bagaimanapun ada sedikit jalan pintas untuk diatas dengan membiarkan formset itu sendiri berurusan dengan formulir pengelolaan:

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

Diatas berakhir memanggil metode as_table pada kelas formset.

\n
\n

Secara manual membangun can_delete dan can_orderLink to this heading#

\n

Jika anda secara manual membangun bidang dalam cetakan, anda dapat membangun parameter can_delete dengan {{ 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

Similarly, if the formset has the ability to order (can_order=True), it is\npossible to render it with {{ form.ORDER }}.

\n
\n
\n

Menggunakan lebih dari satu formset dalam sebuah tampilanLink to this heading#

\n

You are able to use more than one formset in a view if you like. Formsets\nborrow much of its behavior from forms. With that said you are able to use\nprefix to prefix formset form field names with a given value to allow\nmore than one formset to be sent to a view without name clashing. Let's take\na look at how this might be accomplished:

\n
Code
from django.forms import formset_factory\nfrom django.shortcuts import render\nfrom myapp.forms import ArticleForm, BookForm\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(request, 'manage_articles.html', {\n        'article_formset': article_formset,\n        'book_formset': book_formset,\n    })\n
\n

You would then render the formsets as normal. It is important to point out\nthat you need to pass prefix on both the POST and non-POST cases so that\nit is rendered and processed correctly.

\n

Each formset's prefix replaces the default form\nprefix that's added to each field's name and id HTML attributes.

\n
\n
","rootId":"formsets","toc":[{"title":"Menggunakan data awalan dengan formset","anchor":"using-initial-data-with-a-formset","children":[]},{"title":"Membatasi nomor maksimal dari formulir","anchor":"limiting-the-maximum-number-of-forms","children":[]},{"title":"Pengesahan formset","anchor":"formset-validation","children":[{"title":"Memahami ManagementForm","anchor":"understanding-the-managementform","children":[]},{"title":"total_form_count dan initial_form_count","anchor":"total-form-count-and-initial-form-count","children":[]},{"title":"empty_form","anchor":"empty-form","children":[]},{"title":"Penyesuaian pengesahan formset","anchor":"custom-formset-validation","children":[]}]},{"title":"Mensahkan sejumlah formulir dalam formset","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":"Berurusan dengan pengurutan dan penghapusan formulir","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":"Menambahkan bidang-bidang tambahan pada sebuah formset","anchor":"adding-additional-fields-to-a-formset","children":[]},{"title":"Melewatkan parameter penyesuaian pada formulir formset","anchor":"passing-custom-parameters-to-formset-forms","children":[]},{"title":"Menyesuaikan awalan formset","anchor":"customizing-a-formset-s-prefix","children":[]},{"title":"Menggunakan sebuah formset dalam tampilan dan cetakan","anchor":"using-a-formset-in-views-and-templates","children":[{"title":"Secara manual membangun can_delete dan can_order","anchor":"manually-rendered-can-delete-and-can-order","children":[]},{"title":"Menggunakan lebih dari satu formset dalam sebuah tampilan","anchor":"using-more-than-one-formset-in-a-view","children":[]}]}],"breadcrumbs":[{"docname":"topics/index","title":"Menggunakan Django","url":"/id/3.0/topics/"},{"docname":"topics/forms/index","title":"Bekerja dengan formulir","url":"/id/3.0/topics/forms/"}],"prev":{"docname":"topics/forms/index","title":"Bekerja dengan formulir","url":"/id/3.0/topics/forms/"},"next":{"docname":"topics/forms/modelforms","title":"Membuat formulir dari model","url":"/id/3.0/topics/forms/modelforms/"},"formats":{"html":"/id/3.0/topics/forms/formsets/","markdown":"/id/3.0/topics/forms/formsets.md","json":"/id/3.0/topics/forms/formsets.json"},"source":"https://github.com/django/django/blob/stable/3.0.x/docs/topics/forms/formsets.txt","official":"https://docs.djangoproject.com/id/3.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","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}