From 433dd737f94b09043f64b873b0ac067b3f97364b Mon Sep 17 00:00:00 2001 From: David Smith Date: Thu, 30 Apr 2020 08:34:53 +0100 Subject: Fixed #20347 -- Allowed customizing the maximum number of instantiated forms in formsets. Co-authored-by: ethurgood --- docs/ref/forms/formsets.txt | 6 +++++- docs/ref/forms/models.txt | 16 ++++++++++++---- 2 files changed, 17 insertions(+), 5 deletions(-) (limited to 'docs/ref/forms') diff --git a/docs/ref/forms/formsets.txt b/docs/ref/forms/formsets.txt index 778ae20db3..e145eeb103 100644 --- a/docs/ref/forms/formsets.txt +++ b/docs/ref/forms/formsets.txt @@ -11,8 +11,12 @@ Formset API reference. For introductory material about formsets, see the ``formset_factory`` =================== -.. function:: formset_factory(form, formset=BaseFormSet, extra=1, can_order=False, can_delete=False, max_num=None, validate_max=False, min_num=None, validate_min=False) +.. function:: formset_factory(form, formset=BaseFormSet, extra=1, can_order=False, can_delete=False, max_num=None, validate_max=False, min_num=None, validate_min=False, absolute_max=None) Returns a ``FormSet`` class for the given ``form`` class. See :doc:`formsets ` for example usage. + + .. versionchanged:: 3.2 + + The ``absolute_max`` argument was added. diff --git a/docs/ref/forms/models.txt b/docs/ref/forms/models.txt index c5ddf99011..e18660b3c2 100644 --- a/docs/ref/forms/models.txt +++ b/docs/ref/forms/models.txt @@ -52,7 +52,7 @@ Model Form API reference. For introductory material about model forms, see the ``modelformset_factory`` ======================== -.. function:: modelformset_factory(model, form=ModelForm, formfield_callback=None, formset=BaseModelFormSet, extra=1, can_delete=False, can_order=False, max_num=None, fields=None, exclude=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None) +.. function:: modelformset_factory(model, form=ModelForm, formfield_callback=None, formset=BaseModelFormSet, extra=1, can_delete=False, can_order=False, max_num=None, fields=None, exclude=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None, absolute_max=None) Returns a ``FormSet`` class for the given ``model`` class. @@ -62,16 +62,20 @@ Model Form API reference. For introductory material about model forms, see the through to :func:`~django.forms.models.modelform_factory`. Arguments ``formset``, ``extra``, ``max_num``, ``can_order``, - ``can_delete`` and ``validate_max`` are passed through to - :func:`~django.forms.formsets.formset_factory`. See :doc:`formsets + ``can_delete``, ``validate_max``, and ``absolute_max`` are passed through + to :func:`~django.forms.formsets.formset_factory`. See :doc:`formsets ` for details. See :ref:`model-formsets` for example usage. + .. versionchanged:: 3.2 + + The ``absolute_max`` argument was added. + ``inlineformset_factory`` ========================= -.. function:: inlineformset_factory(parent_model, model, form=ModelForm, formset=BaseInlineFormSet, fk_name=None, fields=None, exclude=None, extra=3, can_order=False, can_delete=True, max_num=None, formfield_callback=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None) +.. function:: inlineformset_factory(parent_model, model, form=ModelForm, formset=BaseInlineFormSet, fk_name=None, fields=None, exclude=None, extra=3, can_order=False, can_delete=True, max_num=None, formfield_callback=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None, absolute_max=None) Returns an ``InlineFormSet`` using :func:`modelformset_factory` with defaults of ``formset=``:class:`~django.forms.models.BaseInlineFormSet`, @@ -81,3 +85,7 @@ Model Form API reference. For introductory material about model forms, see the the ``parent_model``, you must specify a ``fk_name``. See :ref:`inline-formsets` for example usage. + + .. versionchanged:: 3.2 + + The ``absolute_max`` argument was added. -- cgit v1.3