diff options
| author | Annabelle Wiegart <annabelle.wiegart@proton.me> | 2026-01-18 20:03:28 +0100 |
|---|---|---|
| committer | Jacob Walls <jacobtylerwalls@gmail.com> | 2026-04-22 17:06:29 -0400 |
| commit | 63c56cda133a85a158502891c40465bc0331d3d9 (patch) | |
| tree | 04380903d14307b71416b2e048ce4be8361cf0df /docs/releases/6.1.txt | |
| parent | dc467fdc3b5744cec71fab876c23a14013e2510b (diff) | |
Fixed #35870 -- Made blank choice label in forms more accessible.
Added new constant django.db.models.fields.BLANK_CHOICE_LABEL for
an accessible and translatable blank choice label in forms.
Deprecated django.db.models.fields.BLANK_CHOICE_DASH constant.
Added the immediately deprecated transitional setting
USE_BLANK_CHOICE_DASH.
Co-Authored-By: Marijke Luttekes <mail@marijkeluttekes.dev>
Diffstat (limited to 'docs/releases/6.1.txt')
| -rw-r--r-- | docs/releases/6.1.txt | 11 |
1 files changed, 10 insertions, 1 deletions
diff --git a/docs/releases/6.1.txt b/docs/releases/6.1.txt index 142ddb631e..a4e10d2102 100644 --- a/docs/releases/6.1.txt +++ b/docs/releases/6.1.txt @@ -244,7 +244,11 @@ File Uploads Forms ~~~~~ -* ... +* The new constant ``django.db.models.fields.BLANK_CHOICE_LABEL`` defines a + more accessible and translatable default label for the blank choice in + forms, which is appended to most ``choices`` lists. The transitional setting + :setting:`USE_BLANK_CHOICE_DASH` allows you to revert back to the old + default label. Generic Views ~~~~~~~~~~~~~ @@ -540,6 +544,11 @@ Miscellaneous used as the top-level value. :lookup:`Key and index lookups <jsonfield.key>` are unaffected by this deprecation. +* The ``django.db.models.fields.BLANK_CHOICE_DASH`` constant is deprecated + in favor of the new constant ``django.db.models.fields.BLANK_CHOICE_LABEL``. + +* The :setting:`USE_BLANK_CHOICE_DASH` transitional setting is deprecated. + * The undocumented ``get_placeholder`` method of :class:`~django.db.models.Field` is deprecated in favor of the newly introduced ``get_placeholder_sql`` method, which has the same input signature |