[2.1.x] Fixed #16995 -- Clarified interaction of initial and extra with model formsets.

Backport of 28dac56aed from master
This commit is contained in:
melipone 2018-09-06 12:00:45 +01:00 committed by Tim Graham
parent 1853e2dbf2
commit 24b3aa0275
2 changed files with 5 additions and 2 deletions

View File

@ -521,6 +521,7 @@ answer newbie questions, and generally made Django that much better:
Mario Gonzalez <gonzalemario@gmail.com> Mario Gonzalez <gonzalemario@gmail.com>
Mariusz Felisiak <felisiak.mariusz@gmail.com> Mariusz Felisiak <felisiak.mariusz@gmail.com>
Mark Biggers <biggers@utsl.com> Mark Biggers <biggers@utsl.com>
Mark Gensler <mark.gensler@protonmail.com>
mark@junklight.com mark@junklight.com
Mark Lavin <markdlavin@gmail.com> Mark Lavin <markdlavin@gmail.com>
Mark Sandstrom <mark@deliciouslynerdy.com> Mark Sandstrom <mark@deliciouslynerdy.com>

View File

@ -877,8 +877,10 @@ As with regular formsets, it's possible to :ref:`specify initial data
parameter when instantiating the model formset class returned by parameter when instantiating the model formset class returned by
:func:`~django.forms.models.modelformset_factory`. However, with model :func:`~django.forms.models.modelformset_factory`. However, with model
formsets, the initial values only apply to extra forms, those that aren't formsets, the initial values only apply to extra forms, those that aren't
attached to an existing model instance. If the extra forms with initial data attached to an existing model instance. If the length of ``initial`` exceeds
aren't changed by the user, they won't be validated or saved. the number of extra forms, the excess initial data is ignored. If the extra
forms with initial data aren't changed by the user, they won't be validated or
saved.
.. _saving-objects-in-the-formset: .. _saving-objects-in-the-formset: