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

[2.2.x] Changed docs to link to Python's description of iterable.

Browse Source 
Backport of e86cc14bd3 from master
This commit is contained in:
Jon Dufresne
2019-05-17 08:27:19 -07:00
committed by Carlton Gibson
parent 0aca34fc83
commit ed221f7c97
4 changed files with 16 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/ref/models/fields.txt
View File

@@ -80,11 +80,11 @@ If a field has ``blank=False``, the field will be required.
.. attribute:: Field.choices
An iterable (e.g., a list or tuple) consisting itself of iterables of exactly
two items (e.g. ``[(A, B), (A, B) ...]``) to use as choices for this field. If
choices are given, they're enforced by :ref:`model validation
<validating-objects>` and the default form widget will be a select box with
these choices instead of the standard text field.
An :term:`iterable` consisting itself of iterables of exactly two items (e.g.
``[(A, B), (A, B) ...]``) to use as choices for this field. If choices are
given, they're enforced by :ref:`model validation <validating-objects>` and the
default form widget will be a select box with these choices instead of the
standard text field.
The first element in each tuple is the actual value to be set on the model,
and the second element is the human-readable name. For example::