Fixed #23354 -- Documented that ModelChoiceField to_field_name should be a unique field.

Thanks Keryn Knight for the suggestion.
This commit is contained in:
Tim Graham 2014-08-27 07:43:13 -04:00
parent 2154004802
commit 83762da3fb
1 changed files with 4 additions and 2 deletions

View File

@ -1106,8 +1106,10 @@ method::
.. attribute:: to_field_name
This optional argument is used to specify the field to use as the value
of the choices in the field's widget. By default it is set to ``None``,
in which case the primary key of each object will be used. For example::
of the choices in the field's widget. Be sure it's a unique field for
the model, otherwise the selected value could match more than one
object. By default it is set to ``None``, in which case the primary key
of each object will be used. For example::
# No custom to_field_name
field1 = forms.ModelChoiceField(queryset=...)