mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-10-31 09:41:08 +00:00
Code Issues 32 Releases Wiki Activity

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

Browse Source 
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
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=...)