diff options
| author | vgolubev <nakmak1998@gmail.com> | 2021-08-01 23:33:12 +0300 |
|---|---|---|
| committer | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2022-01-27 20:45:21 +0100 |
| commit | e87f57fdb8dcdabc452bd15abd015bf6c9b1f7a8 (patch) | |
| tree | 229f0d73438096bd90a93077b3fcda93f07e7151 /docs/ref | |
| parent | 0af9a5fc7d765aa05ea784e2c3237675f3bb4b49 (diff) | |
Fixed #26142 -- Allowed model formsets to prevent new object creation.
Thanks Jacob Walls, David Smith, and Mariusz Felisiak for reviews.
Co-authored-by: parth <parthvin@gmail.com>
Diffstat (limited to 'docs/ref')
| -rw-r--r-- | docs/ref/forms/models.txt | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/docs/ref/forms/models.txt b/docs/ref/forms/models.txt index c0f0757b3e..9b0dbc964d 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, absolute_max=None, can_delete_extra=True, renderer=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, can_delete_extra=True, renderer=None, edit_only=False) Returns a ``FormSet`` class for the given ``model`` class. @@ -67,16 +67,23 @@ Model Form API reference. For introductory material about model forms, see the through to :func:`~django.forms.formsets.formset_factory`. See :doc:`formsets </topics/forms/formsets>` for details. + The ``edit_only`` argument allows :ref:`preventing new objects creation + <model-formsets-edit-only>`. + See :ref:`model-formsets` for example usage. .. versionchanged:: 4.0 The ``renderer`` argument was added. + .. versionchanged:: 4.1 + + The ``edit_only`` 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, absolute_max=None, can_delete_extra=True, renderer=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, can_delete_extra=True, renderer=None, edit_only=False) Returns an ``InlineFormSet`` using :func:`modelformset_factory` with defaults of ``formset=``:class:`~django.forms.models.BaseInlineFormSet`, @@ -90,3 +97,7 @@ Model Form API reference. For introductory material about model forms, see the .. versionchanged:: 4.0 The ``renderer`` argument was added. + + .. versionchanged:: 4.1 + + The ``edit_only`` argument was added. |