innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

[1.7.x] Fixed #23354 -- Documented that ModelChoiceField to_field_name should be a unique field. 

Thanks Keryn Knight for the suggestion.

Backport of 83762da3fb from master
This commit is contained in:
Tim Graham 2014-08-27 07:43:13 -04:00
parent 307eef20e3
commit e86030b3be
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/ref/forms/fields.txt
View File

@ -1061,8 +1061,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=...)