Commit 8e77ac63 authored by Tim Graham's avatar Tim Graham
Browse files

[1.6.x] Fixed #23250 -- Documented that ModelMultipleChoiceField queryset may be None.

Backport of ced3e303 from master
parent adb0c535
Loading
Loading
Loading
Loading
+11 −0
Original line number Diff line number Diff line
@@ -956,6 +956,17 @@ model object (in the case of ``ModelChoiceField``) or multiple model
objects (in the case of ``ModelMultipleChoiceField``) into the
``cleaned_data`` dictionary of the form.

For more complex uses, you can specify ``queryset=None`` when declaring the
form field and then populate the ``queryset`` in the form's ``__init__()``
method::

    class FooMultipleChoiceForm(forms.Form):
        foo_select = forms.ModelMultipleChoiceField(queryset=None)

        def __init__(self, *args, **kwargs):
            super(FooMultipleChoiceForm, self).__init__(*args, **kwargs)
            self.fields['foo_select'].queryset = ...

``ModelChoiceField``
~~~~~~~~~~~~~~~~~~~~