summaryrefslogtreecommitdiff
path: root/docs/topics/forms
AgeCommit message (Collapse)Author
2026-07-24Fixed minor typos and grammatical errors in docs and docstrings.Jacob Walls
Thanks to these people for pointing these out: * Hojeong Park * Natalia Bidart * Sulav Raj Bista
2026-06-30Fixed #37162 -- Updated ContactForm docs example to use safe practices.Mike Edmunds
Updated the `ContactForm` examples in the "Forms" topic and reference docs to avoid broken and unsafe practices around sending email: * Stopped using user-provided `sender` address as `from_email`. Instead, renamed to `contact_email` and used it as the `reply_to` address. * Removed `cc_myself` option to prevent using the form to send spam. Substituted an `urgent` field to demonstrate `BooleanField` use. * Identified email as coming from the contact form and added other content to reduce impersonation/phishing risks. Also updated some example output in the forms reference docs where it had drifted from the example code over time: email fields default to `maxlength=320`; the `ContactForm` example has been using a `TextArea` widget for its message field.
2026-05-07Fixed #37085 -- Added support for object-based form media stylesheet assets.Natalia
Thank you James Walls and James Bligh for reviews. Co-authored-by: Johannes Maron <johannes@maron.family>
2026-05-06Fixed #36784 -- Added csp_nonce_attr template tag for CSP nonce inclusion.Natalia
New default tag `{% csp_nonce_attr %}` was added for explicit CSP nonce inclusion into `<script>` and `<link>` elements. `{% csp_nonce_attr %}` renders `nonce="<value>"` when `csp_nonce` is present in the template context, and renders nothing otherwise. `{% csp_nonce_attr media %}` renders a `Media` object's assets with the nonce attr applied to each tag. Thanks Jacob Walls for the accurate and spot on review comments. Co-authored-by: Johannes Maron <johannes@maron.family>
2026-01-08Relocated content from docs/topics/external-packages.txt where appropriate.Natalia
Following up a forum post and a conversation with the Steering Council, it was decided to remove the docs/topics/external-packages.txt to avoid confusion with the Ecosystem page. Relevant content was moved to their related sections, except for `django-contrib-comments` which is not actively maintained. Thank you Tim Schilling for the review.
2026-01-08Dropped unnecessary usage of "seealso" in BoundField docs.Natalia
2025-10-29Fixed #36329 -- Removed non-code custom link text when cross-referencing ↵Clifford Gama
Python objects. Thanks Bruno Alla, Sarah Boyce, and Jacob Walls for reviews. Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com>
2025-09-17Removed versionadded/changed annotations for 5.2.Jacob Walls
2025-08-29Fixed #35831 -- Documented the model form meta API in model form reference docs.Mustafa Pirbhai
Co-authored-by: Jonathan <3218047+jernwerber@users.noreply.github.com> Co-authored-by: Mustafa <117516335+mspirbhai@users.noreply.github.com>
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-13Fixed incorrect formatting for inline pluralized code references in docs.Clifford Gama
2025-03-12Fixed #35676 -- Made BaseModelForm validate constraints that reference an ↵Clifford Gama
InlineForeignKeyField. Co-authored-by: Simon Charette <charette.s@gmail.com>
2025-01-02Fixed #35886 -- Added support for object-based form media script assets.Johannes Maron
2024-12-02Fixed #35964 -- Cleaned up can_order and can_delete formset examples.antoliny0919
2024-11-18Refs #32339 -- Updated formset docs to reflect default rendering as as_div.antoliny0919
2024-11-13Fixed #35843 -- Clarified formset docs about reordering forms.Clifford Gama
2024-05-22Removed versionadded/changed annotations for 5.0.Natalia
This also removes remaining versionadded/changed annotations for older versions.
2024-04-22Fixed incorrect blockquotes in docs/topics/forms/index.txt.minusf
2024-03-08Corrected code-block directives in topics/forms/formsets.txt.Mitchina
2024-03-04Fixed #35261 -- Corrected Media JS example of object-based paths in docs.Leandro de Souza
`rel` attribute is not valid on `<link>` tags.
2024-01-26Applied Black's 2024 stable style.Mariusz Felisiak
https://github.com/psf/black/releases/tag/24.1.0
2023-11-29Refs #25778 -- Updated some links and references to HTTPS.Adam Johnson
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-30Fixed typo in docs/topics/forms/index.txt.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-23Improved formset docs by using a set instead of a list in the custom ↵Luca Allulli
validation example.
2023-07-22Fixed formatting typo in docs/topics/forms/index.txt.Carlton Gibson
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-03-24Fixed #34077 -- Added form field rendering.David Smith
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 -- Doc'd setting a form's template_name is recomended over using ↵David Smith
as_* methods.
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-15Refs #32339 -- Doc'd BaseFormSet.as_div()David Smith
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-17Removed versionadded/changed annotations for 4.1.Mariusz Felisiak
2022-11-24Adjusted BaseFormSet.get_form_kwargs example in docs.Riccardo Magliocchetti
2022-08-30Refs #30947 -- Changed tuples to lists where appropriate.Alex Morega
2022-08-08Fixed #31721 -- Allowed ModelForm meta to specify form fields.Kamil Turek
2022-05-31Fixed docs build with sphinxcontrib-spelling 7.5.0+.Mariusz Felisiak
sphinxcontrib-spelling 7.5.0+ includes captions of figures in the set of nodes for which the text is checked.
2022-05-17Removed versionadded/changed annotations for 4.0.Carlton Gibson
2022-05-10Fixed #33622 -- Allowed customizing error messages for invalid number of forms.Marc Seguí Coll
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2022-05-05Fixed #32339 -- Added div.html form template.David Smith
2022-05-04Refs #32339 -- Restructured outputting HTML form docs.Carlton Gibson
In the topic doc, promoted the Reusable form templates section. In the reference, re-grouped and promoted the default __str__() rendering path, and then gathered the various as_*() helpers subsequently. Thanks to David Smith for review.
2022-04-28Removed hyphen from pre-/re- prefixes.David
"prepopulate", "preload", and "preprocessing" are already in the spelling_wordlist. This also removes hyphen from double "e" combinations with "pre" and "re", e.g. preexisting, preempt, reestablish, or reenter. See also: - https://ahdictionary.com/word/search.html?q=rerun - https://ahdictionary.com/word/search.html?q=recreate - https://ahdictionary.com/word/search.html?q=predetermined - https://ahdictionary.com/word/search.html?q=reuse - https://ahdictionary.com/word/search.html?q=reopening
2022-04-27Refs #32339 -- Allowed renderer to specify default form and formset templates.Carlton Gibson
Co-authored-by: David Smith <smithdc@gmail.com>
generated by cgit v1.3 (git 2.53.0) at 2026-08-13 12:35:43 +0000