diff options
| author | heathervm <heathervmurray@gmail.com> | 2017-03-31 07:10:08 -0700 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2017-03-31 10:10:08 -0400 |
| commit | 7d1e23775344cc3dead03bd4af45f4fdf134b819 (patch) | |
| tree | 0b1b7aa765e7d21bf9d90f34be87563e32266f60 /docs/topics/forms | |
| parent | a0d29a9abe93cbe87cf818c3b538506e49739b6c (diff) | |
Fixed #27993 -- Fixed model form default fallback for SelectMultiple.
Diffstat (limited to 'docs/topics/forms')
| -rw-r--r-- | docs/topics/forms/modelforms.txt | 12 |
1 files changed, 7 insertions, 5 deletions
diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt index 3ce94c1b0d..1969474b89 100644 --- a/docs/topics/forms/modelforms.txt +++ b/docs/topics/forms/modelforms.txt @@ -335,12 +335,14 @@ doesn't validate -- i.e., if ``form.errors`` evaluates to ``True``. If an optional field doesn't appear in the form's data, the resulting model instance uses the model field :attr:`~django.db.models.Field.default`, if there is one, for that field. This behavior doesn't apply to fields that use -:class:`~django.forms.CheckboxInput` and -:class:`~django.forms.CheckboxSelectMultiple` (or any custom widget whose +:class:`~django.forms.CheckboxInput`, +:class:`~django.forms.CheckboxSelectMultiple`, or +:class:`~django.forms.SelectMultiple` (or any custom widget whose :meth:`~django.forms.Widget.value_omitted_from_data` method always returns -``False``) since an unchecked checkbox doesn't appear in the data of an HTML -form submission. Use a custom form field or widget if you're designing an API -and want the default fallback for a :class:`~django.db.models.BooleanField`. +``False``) since an unchecked checkbox and unselected ``<select multiple>`` +don't appear in the data of an HTML form submission. Use a custom form field or +widget if you're designing an API and want the default fallback behavior for a +field that uses one of these widgets. This ``save()`` method accepts an optional ``commit`` keyword argument, which accepts either ``True`` or ``False``. If you call ``save()`` with |
