Commit 1b89f976 authored by Tim Graham's avatar Tim Graham
Browse files

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

Backport of ced3e303 from master
parent 588afbb2
Loading
Loading
Loading
Loading
+11 −0
Original line number Diff line number Diff line
@@ -1003,6 +1003,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``
~~~~~~~~~~~~~~~~~~~~