Fixed #30917 -- Clarified formsets topic documentation.
This commit is contained in:
parent
f57e174fa6
commit
4c762588ff
|
@ -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.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue