minusf 
							
						 
					 
					
						
						
							
						
						8468ea237d 
					 
					
						
						
							
							[5.0.x] Fixed incorrect blockquotes in docs/topics/forms/index.txt.  
						
						... 
						
						
						
						Backport of bcad5ad92b 
						
						
					 
					
						2024-04-22 22:27:42 -03:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						7f0275d8cb 
					 
					
						
						
							
							[5.0.x] Refs  #32819  -- Used auto_id instead of id_for_label as unique identifier for 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>`.
Backport of 292f1ea90f 
						
						
					 
					
						2023-11-16 13:27:18 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						329ae408bf 
					 
					
						
						
							
							[5.0.x] Fixed typo in docs/topics/forms/index.txt.  
						
						... 
						
						
						
						Backport of 46df3ab244 
						
						
					 
					
						2023-10-30 05:17:55 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						07b7a3ab75 
					 
					
						
						
							
							Fixed formatting typo in docs/topics/forms/index.txt.  
						
						
						
						
					 
					
						2023-07-22 19:48:55 +02:00 
						 
				 
			
				
					
						
							
							
								Gregor Jerše 
							
						 
					 
					
						
						
							
						
						966ecdd482 
					 
					
						
						
							
							Fixed   #32819  -- Established relationship between form fields and their help text.  
						
						... 
						
						
						
						Thanks Nimra for the initial patch.
Thanks Natalia Bidart, Thibaud Colas, David Smith, and Mariusz Felisiak
for reviews. 
						
						
					 
					
						2023-07-06 08:03:19 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						cad376f844 
					 
					
						
						
							
							Fixed   #34077  -- Added form field rendering.  
						
						
						
						
					 
					
						2023-03-24 10:16:30 +01:00 
						 
				 
			
				
					
						
							
							
								django-bot 
							
						 
					 
					
						
						
							
						
						14459f80ee 
					 
					
						
						
							
							Fixed   #34140  -- Reformatted code blocks in docs with blacken-docs.  
						
						
						
						
					 
					
						2023-03-01 13:03:56 +01:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						3cc7a92189 
					 
					
						
						
							
							Refs  #32339  -- Doc'd setting a form's template_name is recomended over using as_* methods.  
						
						
						
						
					 
					
						2023-02-15 10:26:31 +01:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						534ac48297 
					 
					
						
						
							
							Refs  #34140  -- Applied rst code-block to non-Python examples.  
						
						... 
						
						
						
						Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for
reviews. 
						
						
					 
					
						2023-02-10 19:19:13 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						490cccbe7e 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.1.  
						
						
						
						
					 
					
						2023-01-17 11:49:15 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						ac90529cc5 
					 
					
						
						
							
							Fixed docs build with sphinxcontrib-spelling 7.5.0+.  
						
						... 
						
						
						
						sphinxcontrib-spelling 7.5.0+ includes captions of figures in the set
of nodes for which the text is checked. 
						
						
					 
					
						2022-05-31 11:17:01 +02:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						ca1c3151c3 
					 
					
						
						
							
							Removed versionadded/changed annotations for 4.0.  
						
						
						
						
					 
					
						2022-05-17 14:22:06 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						ec5659382a 
					 
					
						
						
							
							Fixed   #32339  -- Added div.html form template.  
						
						
						
						
					 
					
						2022-05-05 14:32:43 +02:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						fde946daff 
					 
					
						
						
							
							Refs  #32339  -- Restructured outputting HTML form docs.  
						
						... 
						
						
						
						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-05-04 11:52:48 +02:00 
						 
				 
			
				
					
						
							
							
								David 
							
						 
					 
					
						
						
							
						
						ce586ed693 
					 
					
						
						
							
							Removed hyphen from pre-/re- prefixes.  
						
						... 
						
						
						
						"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-28 10:44:14 +02:00 
						 
				 
			
				
					
						
							
							
								Carlton Gibson 
							
						 
					 
					
						
						
							
						
						476d4d5087 
					 
					
						
						
							
							Refs  #32339  -- Allowed renderer to specify default form and formset templates.  
						
						... 
						
						
						
						Co-authored-by: David Smith <smithdc@gmail.com > 
						
						
					 
					
						2022-04-27 10:21:04 +02:00 
						 
				 
			
				
					
						
							
							
								David 
							
						 
					 
					
						
						
							
						
						c8459708a7 
					 
					
						
						
							
							Refs  #32339  -- Added use_fieldset to Widget.  
						
						
						
						
					 
					
						2022-03-30 16:28:14 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						75c1127eef 
					 
					
						
						
							
							Alphabetized field attributes in form topic docs.  
						
						
						
						
					 
					
						2022-01-12 08:07:21 +01:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						456466d932 
					 
					
						
						
							
							Fixed   #31026  -- Switched form rendering to template engine.  
						
						... 
						
						
						
						Thanks Carlton Gibson, Keryn Knight, Mariusz Felisiak, and Nick Pope
for reviews.
Co-authored-by: Johannes Hoppe <info@johanneshoppe.com > 
						
						
					 
					
						2021-09-20 15:50:18 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						1024b5e74a 
					 
					
						
						
							
							Fixed 32956 -- Lowercased spelling of "web" and "web framework" where appropriate.  
						
						
						
						
					 
					
						2021-07-29 06:24:12 +02:00 
						 
				 
			
				
					
						
							
							
								Adam Johnson 
							
						 
					 
					
						
						
							
						
						d17b380653 
					 
					
						
						
							
							Refs  #30573  -- Rephrased "Of Course" and "Obvious(ly)" in documentation and comments.  
						
						
						
						
					 
					
						2020-05-04 12:10:47 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						30ca66eadd 
					 
					
						
						
							
							Added missing backticks in various docs.  
						
						
						
						
					 
					
						2020-03-06 11:52:49 +01:00 
						 
				 
			
				
					
						
							
							
								Tobias Kunze 
							
						 
					 
					
						
						
							
						
						4a954cfd11 
					 
					
						
						
							
							Fixed   #30573  -- Rephrased documentation to avoid words that minimise the 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. 
						
						
					 
					
						2019-09-06 13:27:46 +02:00 
						 
				 
			
				
					
						
							
							
								François Freitag 
							
						 
					 
					
						
						
							
						
						9b15ff08ba 
					 
					
						
						
							
							Used auto-numbered lists in documentation.  
						
						
						
						
					 
					
						2018-11-15 13:54:28 -05:00 
						 
				 
			
				
					
						
							
							
								Curtis Maloney 
							
						 
					 
					
						
						
							
						
						c49ea6f591 
					 
					
						
						
							
							Refs  #20910  -- Replaced snippet directive with code-block.  
						
						
						
						
					 
					
						2018-09-10 13:00:34 -04:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						35319bf12c 
					 
					
						
						
							
							Alphabetized imports in various docs.  
						
						... 
						
						
						
						Follow-up of d97cce34097d3fe36c62 
						
						
					 
					
						2018-05-12 19:37:42 +02:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						ff61a25081 
					 
					
						
						
							
							Fixed   #29107  -- Doc'd that ModelForm doesn't actually inherit from Form.  
						
						
						
						
					 
					
						2018-02-08 10:10:28 -05:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						ff05de760c 
					 
					
						
						
							
							Fixed   #29038  -- Removed closing slash from HTML void tags.  
						
						
						
						
					 
					
						2018-01-21 02:09:10 -05:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						ec6121693f 
					 
					
						
						
							
							Fixed   #22383  -- Added support for HTML5 required attribute on required form fields.  
						
						
						
						
					 
					
						2016-04-21 19:16:38 -04:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						38ddd4ab55 
					 
					
						
						
							
							Fixed incorrect rendered widget in forms example.  
						
						
						
						
					 
					
						2016-04-20 21:07:59 -04:00 
						 
				 
			
				
					
						
							
							
								Elif T. Kus 
							
						 
					 
					
						
						
							
						
						bca9faae95 
					 
					
						
						
							
							Fixed   #26020  -- Normalized header stylings in docs.  
						
						
						
						
					 
					
						2016-01-22 12:12:17 -05:00 
						 
				 
			
				
					
						
							
							
								Agnieszka Lasyk 
							
						 
					 
					
						
						
							
						
						1f8dad6915 
					 
					
						
						
							
							Fixed   #25755  -- Unified spelling of "website".  
						
						
						
						
					 
					
						2015-11-16 06:44:14 -05:00 
						 
				 
			
				
					
						
							
							
								John Moses 
							
						 
					 
					
						
						
							
						
						ac09d22f79 
					 
					
						
						
							
							Fixed   #25481  -- Added field.help_text to "Looping over a form's fields" docs.  
						
						
						
						
					 
					
						2015-10-02 12:52:14 -04:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						54848a96dd 
					 
					
						
						
							
							Removed versionadded/changed annotations for 1.8.  
						
						
						
						
					 
					
						2015-09-23 19:31:11 -04:00 
						 
				 
			
				
					
						
							
							
								Moritz Sichert 
							
						 
					 
					
						
						
							
						
						2f53d342f1 
					 
					
						
						
							
							Fixed   #12856  -- Documented BoundField API.  
						
						
						
						
					 
					
						2015-09-21 08:42:14 -04:00 
						 
				 
			
				
					
						
							
							
								I am Clinton 
							
						 
					 
					
						
						
							
						
						ec74dba2ab 
					 
					
						
						
							
							Light edits to docs/topics/forms/index.txt  
						
						
						
						
					 
					
						2015-05-12 09:16:13 -04:00 
						 
				 
			
				
					
						
							
							
								Patrik Lundin 
							
						 
					 
					
						
						
							
						
						f9c212d09a 
					 
					
						
						
							
							Specified file names for example code in docs/topics/forms/index.txt  
						
						
						
						
					 
					
						2015-04-07 09:35:22 -04:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						e0080cf577 
					 
					
						
						
							
							Fixed   #24083  -- Corrected is_bound nature in forms topic docs  
						
						... 
						
						
						
						Thanks ajenhl Trac user for the report. 
						
						
					 
					
						2015-01-06 08:56:53 +01:00 
						 
				 
			
				
					
						
							
							
								Markus Holtermann 
							
						 
					 
					
						
						
							
						
						c7786550c4 
					 
					
						
						
							
							Fixed display of lists after website redesign  
						
						... 
						
						
						
						Thanks Brian Jacobel for the report. refs django/djangoproject.com#197  
						
						
					 
					
						2014-12-17 08:24:00 -05:00 
						 
				 
			
				
					
						
							
							
								nmundar 
							
						 
					 
					
						
						
							
						
						48515ee1f7 
					 
					
						
						
							
							Fixed   #23690  - fixed examples of manual rendering of form fields  
						
						... 
						
						
						
						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-15 13:29:16 +01:00 
						 
				 
			
				
					
						
							
							
								Tim Graham 
							
						 
					 
					
						
						
							
						
						40ba6f21bb 
					 
					
						
						
							
							Fixed spelling errors in docs.  
						
						
						
						
					 
					
						2014-11-11 16:41:09 +01:00 
						 
				 
			
				
					
						
							
							
								Berker Peksag 
							
						 
					 
					
						
						
							
						
						5c517ec218 
					 
					
						
						
							
							Fixed versionchanged indentation in docs/.  
						
						
						
						
					 
					
						2014-11-03 21:40:26 -05:00 
						 
				 
			
				
					
						
							
							
								Thomas Chaumeny 
							
						 
					 
					
						
						
							
						
						d3db878e4b 
					 
					
						
						
							
							Moved CSRF docs out of contrib.  
						
						
						
						
					 
					
						2014-11-03 07:47:39 -05:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						5066fda34d 
					 
					
						
						
							
							Replaced input by textarea in forms docs  
						
						
						
						
					 
					
						2014-09-25 15:09:12 +02:00 
						 
				 
			
				
					
						
							
							
								Erik Romijn 
							
						 
					 
					
						
						
							
						
						cbdda28208 
					 
					
						
						
							
							Fixed   #23075  -- Added documentation on novalidate attribute and made it default for admin  
						
						... 
						
						
						
						Thanks to sehmaschine for the report and to Tim Graham for the review. 
						
						
					 
					
						2014-08-26 14:20:31 +02:00 
						 
				 
			
				
					
						
							
							
								areski 
							
						 
					 
					
						
						
							
						
						9d6551204e 
					 
					
						
						
							
							Removed unnecessary code-block directives.  
						
						
						
						
					 
					
						2014-08-19 16:44:25 -04:00 
						 
				 
			
				
					
						
							
							
								Matt Deacalion Stevens 
							
						 
					 
					
						
						
							
						
						ec85df2fa5 
					 
					
						
						
							
							Fixed and enhanced new HTML form docs.  
						
						
						
						
					 
					
						2014-06-26 13:57:19 -04:00 
						 
				 
			
				
					
						
							
							
								Ramiro Morales 
							
						 
					 
					
						
						
							
						
						77c0a904cb 
					 
					
						
						
							
							Fixed typo in revamped forms intro doc.  
						
						
						
						
					 
					
						2014-06-25 12:15:20 -03:00 
						 
				 
			
				
					
						
							
							
								Daniele Procida 
							
						 
					 
					
						
						
							
						
						cd20b5d186 
					 
					
						
						
							
							Fixed   #22796  -- Added a more basic explanations of forms.  
						
						... 
						
						
						
						Thanks bmispelon, kezabelle, jorgecarleitao, and timgraham for reviews. 
						
						
					 
					
						2014-06-24 14:55:22 -04:00 
						 
				 
			
				
					
						
							
							
								Nick Presta 
							
						 
					 
					
						
						
							
						
						11f0899bbe 
					 
					
						
						
							
							Fixed   #11776  -- Added CSS class for non-field/top of form errors.  
						
						... 
						
						
						
						Thanks Daniel Pope for the suggestion. 
						
						
					 
					
						2014-06-02 15:22:15 -04:00