summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorZowie Beha <113861530+1zzowiebeha@users.noreply.github.com>2023-12-30 16:54:34 -0500
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2024-01-01 18:53:01 +0100
commit8fcd7b01eec85a509762dd8dbb3a27b7ab521e94 (patch)
tree0efeface8f48e83689ea8f18a9a073e29634feb7 /docs
parentc72001644fa794b82fa88a7d2ecc20197b01b6f2 (diff)
Fixed #35072 -- Corrected Field.choices description in models topic.
Diffstat (limited to 'docs')
-rw-r--r--docs/topics/db/models.txt13
1 files changed, 10 insertions, 3 deletions
diff --git a/docs/topics/db/models.txt b/docs/topics/db/models.txt
index cc6c1f5298..b419185bbc 100644
--- a/docs/topics/db/models.txt
+++ b/docs/topics/db/models.txt
@@ -157,9 +157,12 @@ ones:
<Field.blank>`, the field will be required.
:attr:`~Field.choices`
- A :term:`sequence` of 2-tuples to use as choices for this field. If this
- is given, the default form widget will be a select box instead of the
- standard text field and will limit choices to the choices given.
+ A :term:`sequence` of 2-value tuples, a :term:`mapping`, an
+ :ref:`enumeration type <field-choices-enum-types>`, or a callable (that
+ expects no arguments and returns any of the previous formats), to use as
+ choices for this field. If this is given, the default form widget will be a
+ select box instead of the standard text field and will limit choices to the
+ choices given.
A choices list looks like this::
@@ -216,6 +219,10 @@ ones:
Further examples are available in the :ref:`model field reference
<field-choices>`.
+ .. versionchanged:: 5.0
+
+ Support for mappings and callables was added.
+
:attr:`~Field.default`
The default value for the field. This can be a value or a callable
object. If callable it will be called every time a new object is