summaryrefslogtreecommitdiff
path: root/docs/ref/forms/fields.txt
AgeCommit message (Collapse)Author
2026-04-29Fixed #16429 -- Extracted set_choices() method from FilePathField.__init__().TildaDares
2026-04-22Fixed #35870 -- Made blank choice label in forms more accessible.Annabelle Wiegart
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>
2026-03-19Fixed #36904 -- Clarified how to hide form field labels in docs.Amar
2025-09-17Removed versionadded/changed annotations for 5.2.Jacob Walls
2025-08-28Fixed #36570 -- Removed unnecessary :py domain from documentation roles.SaJH
Signed-off-by: SaJH <wogur981208@gmail.com>
2025-08-25Refs #36485 -- Rewrapped docs to 79 columns line length.David Smith
Lines in the docs files were manually adjusted to conform to the 79 columns limit per line (plus newline), improving readability and consistency across the content.
2025-08-25Refs #36485 -- Removed double spaces after periods in sentences.Natalia
2025-08-25Refs #36485 -- Removed unnecessary parentheses in :meth: and :func: roles in ↵David Smith
docs.
2025-03-12Refs #34380 -- Fixed the documented URLField default scheme to https.Sarah Boyce
Missed in 9a3f86e96009c1137b286f6d579b9d812a0dee69.
2025-01-15Refs #34380 -- Changed the URLField default scheme to https and removed ↵Sarah Boyce
FORMS_URLFIELD_ASSUME_HTTPS per deprecation timeline.
2025-01-15Removed versionadded/changed annotations for 5.1.Sarah Boyce
This also removes remaining versionadded/changed annotations for older versions.
2025-01-15Fixed #35521 -- Allowed overriding BoundField class on fields, forms and ↵Matthias Kestenholz
renderers. Thank you Sarah Boyce, Carlton Gibson, Tim Schilling and Adam Johnson for reviews. Co-authored-by: Christophe Henry <contact@c-henry.fr> Co-authored-by: David Smith <smithdc@gmail.com> Co-authored-by: Natalia <124304+nessita@users.noreply.github.com> Co-authored-by: Matthias Kestenholz <mk@feinheit.ch>
2025-01-14Fixed CVE-2024-56374 -- Mitigated potential DoS in IPv6 validation.Michael Manfre
Thanks Saravana Kumar for the report, and Sarah Boyce and Mariusz Felisiak for the reviews. Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2024-11-27Removed trailing whitespace in docs.Adam Zapletal
2024-11-05Fixed #35880 -- Removed invalid example in form Field.required docs due to ↵antoliny0919
CharField.strip. CharField.strip was introduced in 11cac1bd8ef7546ca32d9969d4348bf412dc6664, and is True by default, meaning the previous example of " " raised a ValidationError.
2024-11-04Made minor edits to form fields docs.antoliny0919
2024-08-05Used :pypi: role in docs where appropriate.Mariusz Felisiak
2024-05-22Removed versionadded/changed annotations for 5.0.Natalia
This also removes remaining versionadded/changed annotations for older versions.
2024-04-26Fixed #20744 -- Removed hint that arbitrary kwargs are allowed when creating ↵Adam Zapletal
forms.Fields.
2023-11-29Refs #25778 -- Updated some links and references to HTTPS.Adam Johnson
2023-11-28Refs #34380 -- Added FORMS_URLFIELD_ASSUME_HTTPS transitional setting.Mariusz Felisiak
This allows early adoption of the new default "https".
2023-11-25Refs #34380 -- Improved docs for forms.URLField.assume_scheme.Adam Johnson
2023-11-17Refs #32819 -- Established relationship between form fieldsets and their ↵David Smith
help text. This adds aria-describedby for widgets rendered in a fieldset such as radios. aria-describedby for these widgets is added to the <fieldset> element rather than each <input>.
2023-11-16Refs #32819 -- Used auto_id instead of id_for_label as unique identifier for ↵David Smith
the field. `id_for_label` is blank for widgets with multiple inputs such as radios and multiple checkboxes. Therefore , `help_text` for fields using these widgets cannot currently be associated using `aria-describedby`. `id_for_label` is being used as a guard to avoid incorrectly adding `aria-describedby` to those widgets. This change uses `auto_id` as the unique identified for the fields `help_text`. A guard is added to avoid incorrectly adding `aria-describedby` to inputs by checking the widget's `use_fieldset` attribute. Fields rendered in a `<fieldset>` should have `aria-describedby` added to the `<fieldset>` and not every `<input>`.
2023-10-25Added missing pycon directives in various docs.Mariusz Felisiak
2023-09-18Removed versionadded/changed annotations for 4.2.Mariusz Felisiak
This also removes remaining versionadded/changed annotations for older versions.
2023-08-30 Fixed #31262 -- Added support for mappings on model fields and ↵Nick Pope
ChoiceField's choices.
2023-08-01Fixed #32820 -- Added aria-invalid="true" to fields with errors.Gregor Jerše
Co-authored-by: Demetris Stavrou <demestav@gmail.com> Co-authored-by: David Smith <smithdc@gmail.com>
2023-07-18Added reference to TypedChoiceField in ChoiceField docs.David Sanders
2023-07-06Fixed #32819 -- Established relationship between form fields and their help ↵Gregor Jerše
text. Thanks Nimra for the initial patch. Thanks Natalia Bidart, Thibaud Colas, David Smith, and Mariusz Felisiak for reviews.
2023-07-03Fixed CVE-2023-36053 -- Prevented potential ReDoS in EmailValidator and ↵Mariusz Felisiak
URLValidator. Thanks Seokchan Yoon for reports.
2023-06-16Fixed #34473 -- Fixed step validation for form fields with non-zero minimum ↵Jacob Rief
value.
2023-04-28Fixed #34380 -- Allowed specifying a default URL scheme in forms.URLField.Coen van der Kamp
This also deprecates "http" as the default scheme.
2023-04-03Fixed #34431 -- Improved Date/DateTimeField/TimeField.input_formats docs.Edison Wang
2023-03-24Fixed #34077 -- Added form field rendering.David Smith
2023-03-21Fixed #34388 -- Allowed using choice enumeration types directly on model and ↵T. Franzel
form fields.
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-02-28Refs #34140 -- Corrected rst code-block and various formatting issues in docs.Joseph Victor Zammit
2023-02-15Refs #32339 -- Updated docs to reflect default <div> style form rendering in ↵David Smith
Django 5.0. Follow up to 98756c685ee173bbd43f21ed0553f808be835ce5.
2023-02-10Refs #34140 -- Applied rst code-block to non-Python examples.Carlton Gibson
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for reviews.
2023-01-17Refs #32873 -- Removed settings.USE_L10N per deprecation timeline.Mariusz Felisiak
2023-01-17Removed versionadded/changed annotations for 4.1.Mariusz Felisiak
2022-05-17Removed versionadded/changed annotations for 4.0.Carlton Gibson
2022-05-12Fixed #32559 -- Added 'step_size’ to numeric form fields.Kapil Bansal
Co-authored-by: Jacob Rief <jacob.rief@uibk.ac.at>
2022-05-03Fixed #33658 -- Doc'd ModelChoiceField.blank attribute.Alokik Vijay
Thanks Mariusz Felisiak for reviewing.
2021-12-28Avoided counting attributes and methods in docs.Mariusz Felisiak
2021-12-02Fixed #33334 -- Alphabetized form and model fields in reference docs.Shivam Durgbuns
2021-01-26Fixed #32347 -- Made ModelChoiceField include the value in ValidationError ↵Jerin Peter George
for invalid_choice.
2021-01-14Refs #8760 -- Removed "list" message for ModelMultipleChoiceField per ↵Mariusz Felisiak
deprecation timeline.
2021-01-14Removed versionadded/changed annotations for 3.1.Mariusz Felisiak