mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-06-05 03:29:12 +00:00
Code Issues 32 Releases Wiki Activity

Correct an example in docs/modelforms.txt, and fix some reST formatting

Browse Source 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@7222 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
James Bennett 2008-03-11 06:40:50 +00:00
parent 42712048d3
commit 866d7fa961
1 changed files with 24 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
docs/modelforms.txt
View File

@ -226,7 +226,7 @@ For example::
# Create a form instance with POST data. # Create a form instance with POST data.
>>> a = Author() >>> a = Author()
>>> f = AuthorForm(a, request.POST) >>> f = AuthorForm(request.POST, instance=a)
# Create and save the new author instance. There's no need to do anything else. # Create and save the new author instance. There's no need to do anything else.
>>> new_author = f.save() >>> new_author = f.save()
@ -238,34 +238,34 @@ In some cases, you may not want all the model fields to appear on the generated
form. There are three ways of telling ``ModelForm`` to use only a subset of the form. There are three ways of telling ``ModelForm`` to use only a subset of the
model fields: model fields:
1. Set ``editable=False`` on the model field. As a result, *any* form 1. Set ``editable=False`` on the model field. As a result, *any* form
created from the model via ``ModelForm`` will not include that created from the model via ``ModelForm`` will not include that
field. field.
2. Use the ``fields`` attribute of the ``ModelForm``'s inner ``Meta`` class. 2. Use the ``fields`` attribute of the ``ModelForm``'s inner ``Meta``
This attribute, if given, should be a list of field names to include in class. This attribute, if given, should be a list of field names
the form. to include in the form.
3. Use the ``exclude`` attribute of the ``ModelForm``'s inner ``Meta`` class. 3. Use the ``exclude`` attribute of the ``ModelForm``'s inner ``Meta``
This attribute, if given, should be a list of field names to exclude class. This attribute, if given, should be a list of field names
the form. to exclude the form.
For example, if you want a form for the ``Author`` model (defined above) For example, if you want a form for the ``Author`` model (defined
that includes only the ``name`` and ``title`` fields, you would specify above) that includes only the ``name`` and ``title`` fields, you would
``fields`` or ``exclude`` like this:: specify ``fields`` or ``exclude`` like this::
class PartialAuthorForm(ModelForm): class PartialAuthorForm(ModelForm):
class Meta: class Meta:
model = Author model = Author
fields = ('name', 'title') fields = ('name', 'title')
class PartialAuthorForm(ModelForm):
class Meta:
model = Author
exclude = ('birth_date',)
class PartialAuthorForm(ModelForm): Since the Author model has only 3 fields, 'name', 'title', and
class Meta: 'birth_date', the forms above will contain exactly the same fields.
model = Author
exclude = ('birth_date',)
Since the Author model has only 3 fields, 'name', 'title', and
'birth_date', the forms above will contain exactly the same fields.
.. note:: .. note::