mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-02-22 07:24:59 +00:00
Code Issues 32 Releases Wiki Activity

Fixed #13015 -- Clarified language about model instances attached to forms.

Browse Source
This commit is contained in:
Tim Graham 2015-02-28 16:53:06 -05:00
parent 358850781f
commit a40a34a4b2
1 changed files with 18 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -232,7 +232,7 @@ Overriding the clean() method
You can override the ``clean()`` method on a model form to provide additional You can override the ``clean()`` method on a model form to provide additional
validation in the same way you can on a normal form. validation in the same way you can on a normal form.
A model form instance bound to a model object will contain an ``instance`` A model form instance attached to a model object will contain an ``instance``
attribute that gives its methods access to that specific model instance. attribute that gives its methods access to that specific model instance.
.. warning:: .. warning::
@ -674,6 +674,21 @@ There are a couple of things to note, however.
a default field. To opt-out from default fields, see a default field. To opt-out from default fields, see
:ref:`modelforms-selecting-fields`. :ref:`modelforms-selecting-fields`.
Providing initial values
------------------------
As with regular forms, it's possible to specify initial data for forms by
specifying an ``initial`` parameter when instantiating the form. Initial
values provided this way will override both initial values from the form field
and values from an attached model instance. For example::
>>> article = Article.objects.get(pk1=)
>>> article.headline
'My headline'
>>> form = ArticleForm(initial={'headline': 'Initial headline'), instance=article)
>>> form['pub_date'].value()
'Initial headline'
.. _modelforms-factory: .. _modelforms-factory:
ModelForm factory function ModelForm factory function
@ -840,8 +855,8 @@ As with regular formsets, it's possible to :ref:`specify initial data
<formsets-initial-data>` for forms in the formset by specifying an ``initial`` <formsets-initial-data>` for forms in the formset by specifying an ``initial``
parameter when instantiating the model formset class returned by parameter when instantiating the model formset class returned by
:func:`~django.forms.models.modelformset_factory`. However, with model :func:`~django.forms.models.modelformset_factory`. However, with model
formsets, the initial values only apply to extra forms, those that aren't bound formsets, the initial values only apply to extra forms, those that aren't
to an existing object instance. attached to an existing model instance.
.. _saving-objects-in-the-formset: .. _saving-objects-in-the-formset: