Fixed #33658 -- Doc'd ModelChoiceField.blank attribute.

Thanks Mariusz Felisiak for reviewing.
This commit is contained in:
Alokik Vijay 2022-04-30 21:29:51 +05:30 committed by Mariusz Felisiak
parent aa8b9279e4
commit df22566748
1 changed files with 13 additions and 4 deletions

View File

@ -1235,7 +1235,7 @@ generating choices. See :ref:`iterating-relationship-choices` for details.
are derived and which is used to validate the user's selection. It's
evaluated when the form is rendered.
``ModelChoiceField`` also takes two optional arguments:
``ModelChoiceField`` also takes several optional arguments:
.. attribute:: empty_label
@ -1251,9 +1251,11 @@ generating choices. See :ref:`iterating-relationship-choices` for details.
# No empty label
field2 = forms.ModelChoiceField(queryset=..., empty_label=None)
Note that if a ``ModelChoiceField`` is required and has a default
initial value, no empty choice is created (regardless of the value
of ``empty_label``).
Note that no empty choice is created (regardless of the value of
``empty_label``) if a ``ModelChoiceField`` is required and has a
default initial value, or a ``widget`` is set to
:class:`~django.forms.RadioSelect` and the
:attr:`~ModelChoiceField.blank` argument is ``False``.
.. attribute:: to_field_name
@ -1291,6 +1293,13 @@ generating choices. See :ref:`iterating-relationship-choices` for details.
...
</select>
.. attribute:: blank
When using the :class:`~django.forms.RadioSelect` widget, this optional
boolean argument determines whether an empty choice is created. By
default, ``blank`` is ``False``, in which case no empty choice is
created.
``ModelChoiceField`` also has the attribute:
.. attribute:: iterator