Fixed #30917 -- Clarified formsets topic documentation.

This commit is contained in:
Ken Whitesell 2019-10-30 08:39:23 +01:00 committed by Carlton Gibson
parent f57e174fa6
commit 4c762588ff
1 changed files with 5 additions and 5 deletions

View File

@ -21,9 +21,9 @@ a formset out of an ``ArticleForm`` you would do::
>>> from django.forms import formset_factory >>> from django.forms import formset_factory
>>> ArticleFormSet = formset_factory(ArticleForm) >>> ArticleFormSet = formset_factory(ArticleForm)
You now have created a formset named ``ArticleFormSet``. The formset gives you You now have created a formset class named ``ArticleFormSet``.
the ability to iterate over the forms in the formset and display them as you Instantiating the formset gives you the ability to iterate over the forms
would with a regular form:: in the formset and display them as you would with a regular form::
>>> formset = ArticleFormSet() >>> formset = ArticleFormSet()
>>> for form in formset: >>> 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 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, that is displayed is controlled by the ``extra`` parameter. By default,
:func:`~django.forms.formsets.formset_factory` defines one extra form; the :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) >>> 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 created. You can change this order by providing an alternate implementation for
the ``__iter__()`` method. the ``__iter__()`` method.