p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

[3.0.x] Fixed #30917 -- Clarified formsets topic documentation. 

Backport of 4c762588ff from master
This commit is contained in:
Ken Whitesell 2019-10-30 08:39:23 +01:00 committed by Carlton Gibson
parent 4037b4c2b5
commit 574f238582
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/topics/forms/formsets.txt
View File

@ -21,9 +21,9 @@ a formset out of an ``ArticleForm`` you would do::
>>> from django.forms import formset_factory
>>> ArticleFormSet = formset_factory(ArticleForm)
You now have created a formset named ``ArticleFormSet``. The formset gives you
the ability to iterate over the forms in the formset and display them as you
would with a regular form::
You now have created a formset class named ``ArticleFormSet``.
Instantiating the formset gives you the ability to iterate over the forms
in the formset and display them as you would with a regular form::
>>> formset = ArticleFormSet()
>>> for form in formset:
@ -34,11 +34,11 @@ would with a regular form::
As you can see it only displayed one empty form. The number of empty forms
that is displayed is controlled by the ``extra`` parameter. By default,
:func:`~django.forms.formsets.formset_factory` defines one extra form; the
following example will display two blank forms::
following example will create a formset class to display two blank forms::
>>> ArticleFormSet = formset_factory(ArticleForm, extra=2)
Iterating over the ``formset`` will render the forms in the order they were
Iterating over a formset will render the forms in the order they were
created. You can change this order by providing an alternate implementation for
the ``__iter__()`` method.