Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

[1.0.X] Fixed #10845 -- Clarified the examples for using ModelForms w…

…ith fields or exclude specified. Thanks to Andrew Durdin for the suggestion.

Merge of r10972 from trunk.


git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.0.X@10975 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 922aed54658f2b7ad714f3ba685f0f696e70e499 1 parent 383c46d
@freakboy3742 freakboy3742 authored
Showing with 13 additions and 10 deletions.
  1. +13 −10 docs/topics/forms/modelforms.txt
View
23 docs/topics/forms/modelforms.txt
@@ -318,16 +318,19 @@ Since the Author model has only 3 fields, 'name', 'title', and
to be empty, and does not provide a default value for the missing fields,
any attempt to ``save()`` a ``ModelForm`` with missing fields will fail.
To avoid this failure, you must instantiate your model with initial values
- for the missing, but required fields, or use ``save(commit=False)`` and
- manually set any extra required fields::
+ for the missing, but required fields::
- instance = Instance(required_field='value')
- form = InstanceForm(request.POST, instance=instance)
- new_instance = form.save()
+ author = Author(title='Mr')
+ form = PartialAuthorForm(request.POST, instance=author)
+ form.save()
- instance = form.save(commit=False)
- instance.required_field = 'new value'
- new_instance = instance.save()
+ Alternatively, you can use ``save(commit=False)`` and manually set
+ any extra required fields::
+
+ form = PartialAuthorForm(request.POST)
+ author = form.save(commit=False)
+ author.title = 'Mr'
+ author.save()
See the `section on saving forms`_ for more details on using
``save(commit=False)``.
@@ -531,8 +534,8 @@ number of objects needed::
>>> formset.initial
[{'id': 1, 'name': u'Charles Baudelaire'}, {'id': 3, 'name': u'Paul Verlaine'}]
-If the value of ``max_num`` is higher than the number of objects returned, up to
-``extra`` additional blank forms will be added to the formset, so long as the
+If the value of ``max_num`` is higher than the number of objects returned, up to
+``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=2)

0 comments on commit 922aed5

Please sign in to comment.
Something went wrong with that request. Please try again.