From ced3e303ca6c902c14d08b68806230ce04c71ff7 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Tue, 26 Aug 2014 13:52:20 -0400 Subject: [PATCH] Fixed #23250 -- Documented that ModelMultipleChoiceField queryset may be None. --- docs/ref/forms/fields.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt index 1d8a1c9b5d..b855e2a10d 100644 --- a/docs/ref/forms/fields.txt +++ b/docs/ref/forms/fields.txt @@ -1048,6 +1048,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`` ~~~~~~~~~~~~~~~~~~~~