innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

Fixed #11138 -- Corrected the description of behavior related to the max_num parameter for model formsets. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10819 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Karen Tracey 2009-05-18 16:00:29 +00:00
parent 5a5842ccf2
commit ae95edf91d
1 changed files with 5 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/topics/forms/modelforms.txt
View File

@ -552,7 +552,7 @@ Limiting the number of editable objects
As with regular formsets, you can use the ``max_num`` parameter to As with regular formsets, you can use the ``max_num`` parameter to
``modelformset_factory`` to limit the number of forms displayed. With ``modelformset_factory`` to limit the number of forms displayed. With
model formsets, this properly limits the query to select only the maximum model formsets, this property limits the query to select only the maximum
number of objects needed:: number of objects needed::
>>> Author.objects.order_by('name') >>> Author.objects.order_by('name')
@ -563,10 +563,11 @@ number of objects needed::
>>> formset.initial >>> formset.initial
[{'id': 1, 'name': u'Charles Baudelaire'}, {'id': 3, 'name': u'Paul Verlaine'}] [{'id': 1, 'name': u'Charles Baudelaire'}, {'id': 3, 'name': u'Paul Verlaine'}]
If the value of ``max_num`` is less than the total objects returned, the If the value of ``max_num`` is higher than the number of objects returned, up to
formset will fill the rest with extra forms:: ``extra`` additional blank forms will be added to the formset, so long as the
total number of forms does not exceed ``max_num``::
>>> AuthorFormSet = modelformset_factory(Author, max_num=4, extra=1) >>> AuthorFormSet = modelformset_factory(Author, max_num=4, extra=2)
>>> formset = AuthorFormSet(queryset=Author.objects.order_by('name')) >>> formset = AuthorFormSet(queryset=Author.objects.order_by('name'))
>>> for form in formset.forms: >>> for form in formset.forms:
... print form.as_table() ... print form.as_table()