1
0
mirror of https://github.com/django/django.git synced 2025-03-14 03:10:45 +00:00

[1.5.x] Fixed #21539 -- Added example of modelformset_factory's form argument

Backport of 1fa681ee11 from master
This commit is contained in:
Alasdair Nicol 2013-12-01 02:05:15 +00:00 committed by Tim Graham
parent a53820b1b1
commit e4174da34a

View File

@ -646,6 +646,30 @@ instances of the model, you can specify an empty QuerySet::
>>> AuthorFormSet(queryset=Author.objects.none())
Changing the ``form``
---------------------
By default, when you use ``modelformset_factory``, a model form will
be created using :func:`~django.forms.models.modelform_factory`.
Often, it can be useful to specify a custom model form. For example,
you can create a custom model form that has custom validation::
class AuthorForm(forms.ModelForm):
class Meta:
model = Author
fields = ('name', 'title')
def clean_name(self):
# custom validation for the name field
...
Then, pass your model form to the factory function::
AuthorFormSet = modelformset_factory(Author, form=AuthorForm)
It is not always necessary to define a custom model form. The
``modelformset_factory`` function has several arguments which are
passed through to ``modelform_factory``, which are described below.
Controlling which fields are used with ``fields`` and ``exclude``
-----------------------------------------------------------------