summaryrefslogtreecommitdiff
path: root/docs/topics/forms/index.txt
AgeCommit message (Collapse)Author
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-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 unnecessary parentheses in :meth: and :func: roles in ↵David Smith
docs.
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
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-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-15Refs #32339 -- Doc'd setting a form's template_name is recomended over using ↵David Smith
as_* methods.
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-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-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>
2022-03-30Refs #32339 -- Added use_fieldset to Widget.David
2022-01-12Alphabetized field attributes in form topic docs.David Smith
2021-09-20Fixed #31026 -- Switched form rendering to template engine.David Smith
Thanks Carlton Gibson, Keryn Knight, Mariusz Felisiak, and Nick Pope for reviews. Co-authored-by: Johannes Hoppe <info@johanneshoppe.com>
2021-07-29Fixed 32956 -- Lowercased spelling of "web" and "web framework" where ↵David Smith
appropriate.
2020-05-04Refs #30573 -- Rephrased "Of Course" and "Obvious(ly)" in documentation and ↵Adam Johnson
comments.
2020-03-06Added missing backticks in various docs.Mariusz Felisiak
2019-09-06Fixed #30573 -- Rephrased documentation to avoid words that minimise the ↵Tobias Kunze
involved difficulty. This patch does not remove all occurrences of the words in question. Rather, I went through all of the occurrences of the words listed below, and judged if they a) suggested the reader had some kind of knowledge/experience, and b) if they added anything of value (including tone of voice, etc). I left most of the words alone. I looked at the following words: - simply/simple - easy/easier/easiest - obvious - just - merely - straightforward - ridiculous Thanks to Carlton Gibson for guidance on how to approach this issue, and to Tim Bell for providing the idea. But the enormous lion's share of thanks go to Adam Johnson for his patient and helpful review.
2018-11-15Used auto-numbered lists in documentation.François Freitag
2018-09-10Refs #20910 -- Replaced snippet directive with code-block.Curtis Maloney
2018-05-12Alphabetized imports in various docs.Mariusz Felisiak
Follow-up of d97cce34096043b019e818a7fb98c0f9f073704c and 7d3fe36c626a3268413eb86d37920f132eb4a54f.
2018-02-08Fixed #29107 -- Doc'd that ModelForm doesn't actually inherit from Form.Tim Graham
2018-01-21Fixed #29038 -- Removed closing slash from HTML void tags.Jon Dufresne
2016-04-21Fixed #22383 -- Added support for HTML5 required attribute on required form ↵Jon Dufresne
fields.
2016-04-20Fixed incorrect rendered widget in forms example.Jon Dufresne
2016-01-22Fixed #26020 -- Normalized header stylings in docs.Elif T. Kus
2015-11-16Fixed #25755 -- Unified spelling of "website".Agnieszka Lasyk
2015-10-02Fixed #25481 -- Added field.help_text to "Looping over a form's fields" docs.John Moses
2015-09-23Removed versionadded/changed annotations for 1.8.Tim Graham
2015-09-21Fixed #12856 -- Documented BoundField API.Moritz Sichert
2015-05-12Light edits to docs/topics/forms/index.txtI am Clinton
2015-04-07Specified file names for example code in docs/topics/forms/index.txtPatrik Lundin
2015-01-06Fixed #24083 -- Corrected is_bound nature in forms topic docsClaude Paroz
Thanks ajenhl Trac user for the report.
2014-12-17Fixed display of lists after website redesignMarkus Holtermann
Thanks Brian Jacobel for the report. refs django/djangoproject.com#197
2014-11-15Fixed #23690 - fixed examples of manual rendering of form fieldsnmundar
Documentation for rendering form fields manually is now updated to use fields id_for_label instead of hardcoded values with additional mention of label_tag for alternative generation of complete label tag.
2014-11-11Fixed spelling errors in docs.Tim Graham
2014-11-03Fixed versionchanged indentation in docs/.Berker Peksag
2014-11-03Moved CSRF docs out of contrib.Thomas Chaumeny
2014-09-25Replaced input by textarea in forms docsClaude Paroz
2014-08-26Fixed #23075 -- Added documentation on novalidate attribute and made it ↵Erik Romijn
default for admin Thanks to sehmaschine for the report and to Tim Graham for the review.