From 87c5e7efebd040aef0f0479ccf86877155bb5cea Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Fri, 30 Sep 2016 14:49:50 -0400 Subject: Refs #27186 -- Fixed model form default fallback for CheckboxSelectMultiple. --- docs/ref/forms/widgets.txt | 9 +++++---- docs/releases/1.10.2.txt | 8 ++++---- docs/topics/forms/modelforms.txt | 3 ++- 3 files changed, 11 insertions(+), 9 deletions(-) (limited to 'docs') diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt index 8a6864b5b7..99514e46a2 100644 --- a/docs/ref/forms/widgets.txt +++ b/docs/ref/forms/widgets.txt @@ -280,10 +280,11 @@ foundation for custom widgets. The method's result affects whether or not a field in a model form :ref:`falls back to its default `. - A special case is :class:`~django.forms.CheckboxInput`, which always - returns ``False`` because an unchecked checkbox doesn't appear in the - data of an HTML form submission, so it's unknown whether or not the - user actually submitted a value. + Special cases are :class:`~django.forms.CheckboxInput` and + :class:`~django.forms.CheckboxSelectMultiple`, which always return + ``False`` because an unchecked checkbox doesn't appear in the data of + an HTML form submission, so it's unknown whether or not the user + actually submitted a value. ``MultiWidget`` --------------- diff --git a/docs/releases/1.10.2.txt b/docs/releases/1.10.2.txt index 075eb947f9..78447dccba 100644 --- a/docs/releases/1.10.2.txt +++ b/docs/releases/1.10.2.txt @@ -18,10 +18,10 @@ Bugfixes * Disabled system check for URL patterns beginning with a '/' when ``APPEND_SLASH=False`` (:ticket:`27238`). -* Fixed model form ``default`` fallback for ``MultiWidget``, ``FileInput``, - ``SplitDateTimeWidget``, ``SelectDateWidget``, and ``SplitArrayWidget`` - (:ticket:`27186`). Custom widgets affected by this issue may need to - implement a :meth:`~django.forms.Widget.value_omitted_from_data` method. +* Fixed model form ``default`` fallback for ``CheckboxSelectMultiple``, + ``MultiWidget``, ``FileInput``, ``SplitDateTimeWidget``, ``SelectDateWidget``, + and ``SplitArrayWidget`` (:ticket:`27186`). Custom widgets affected by this + issue should implement :meth:`~django.forms.Widget.value_omitted_from_data`. * Fixed a crash in ``runserver`` logging during a "Broken pipe" error (:ticket:`27271`). diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt index e0b957f9b3..bc0c124014 100644 --- a/docs/topics/forms/modelforms.txt +++ b/docs/topics/forms/modelforms.txt @@ -337,7 +337,8 @@ 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` (or any custom widget whose +:class:`~django.forms.CheckboxInput` and +:class:`~django.forms.CheckboxSelectMultiple` (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 -- cgit v1.3