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 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						500e01073a 
					 
					
						
						
							
							Fixed   #31262  -- Added support for mappings on model fields and ChoiceField's choices.  
						
						
						
						
					 
					
						2023-08-30 22:57:40 -03:00 
						 
				 
			
				
					
						
							
							
								Luca Allulli 
							
						 
					 
					
						
						
							
						
						c59be9f1da 
					 
					
						
						
							
							Improved formset docs by using a set instead of a list in the custom validation example.  
						
						
						
						
					 
					
						2023-08-23 22:24:43 -03: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 
						 
				 
			
				
					
						
							
							
								Joseph Victor Zammit 
							
						 
					 
					
						
						
							
						
						ba755ca131 
					 
					
						
						
							
							Refs  #34140  -- Corrected rst code-block and various formatting issues in docs.  
						
						
						
						
					 
					
						2023-02-28 12:21:37 +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 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						232b60a21b 
					 
					
						
						
							
							Refs  #32339  -- Updated docs to reflect default <div> style form rendering in Django 5.0.  
						
						... 
						
						
						
						Follow up to 98756c685e 
						
						
					 
					
						2023-02-15 10:14:09 +01:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						4038a8df0b 
					 
					
						
						
							
							Refs  #32339  -- Doc'd BaseFormSet.as_div()  
						
						
						
						
					 
					
						2023-02-15 09:24:08 +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 
						 
				 
			
				
					
						
							
							
								Riccardo Magliocchetti 
							
						 
					 
					
						
						
							
						
						df2db8b4a5 
					 
					
						
						
							
							Adjusted BaseFormSet.get_form_kwargs example in docs.  
						
						
						
						
					 
					
						2022-11-24 15:16:31 +01:00 
						 
				 
			
				
					
						
							
							
								Alex Morega 
							
						 
					 
					
						
						
							
						
						de6c9c7054 
					 
					
						
						
							
							Refs  #30947  -- Changed tuples to lists where appropriate.  
						
						
						
						
					 
					
						2022-08-30 09:57:17 +02:00 
						 
				 
			
				
					
						
							
							
								Kamil Turek 
							
						 
					 
					
						
						
							
						
						e03cdf76e7 
					 
					
						
						
							
							Fixed   #31721  -- Allowed ModelForm meta to specify form fields.  
						
						
						
						
					 
					
						2022-08-08 09:46:05 +02: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 
						 
				 
			
				
					
						
							
							
								Marc Seguí Coll 
							
						 
					 
					
						
						
							
						
						262fde94de 
					 
					
						
						
							
							Fixed   #33622  -- Allowed customizing error messages for invalid number of forms.  
						
						... 
						
						
						
						Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com > 
						
						
					 
					
						2022-05-10 13:42:31 +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 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						39ae8d740e 
					 
					
						
						
							
							Added missing backticks to function names.  
						
						
						
						
					 
					
						2022-03-17 11:10:03 +01:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						4c76ffc2d6 
					 
					
						
						
							
							Fixed   #29490  -- Added support for object-based Media CSS and JS paths.  
						
						
						
						
					 
					
						2022-02-10 08:48:27 +01:00 
						 
				 
			
				
					
						
							
							
								Mike Lissner 
							
						 
					 
					
						
						
							
						
						e459b0f5a0 
					 
					
						
						
							
							Improved example of using a custom queryset in Model formsets docs.  
						
						
						
						
					 
					
						2022-02-03 06:58:14 +01:00 
						 
				 
			
				
					
						
							
							
								vgolubev 
							
						 
					 
					
						
						
							
						
						e87f57fdb8 
					 
					
						
						
							
							Fixed   #26142  -- Allowed model formsets to prevent new object creation.  
						
						... 
						
						
						
						Thanks Jacob Walls, David Smith, and Mariusz Felisiak for reviews.
Co-authored-by: parth <parthvin@gmail.com > 
						
						
					 
					
						2022-01-27 20:45:21 +01:00 
						 
				 
			
				
					
						
							
							
								Claude Paroz 
							
						 
					 
					
						
						
							
						
						7c4f396509 
					 
					
						
						
							
							Stopped including type="text/css" attributes for CSS link tags.  
						
						
						
						
					 
					
						2022-01-22 16:38:14 +01:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						75c1127eef 
					 
					
						
						
							
							Alphabetized field attributes in form topic docs.  
						
						
						
						
					 
					
						2022-01-12 08:07:21 +01:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						ad6bb20557 
					 
					
						
						
							
							Avoided counting attributes and methods in docs.  
						
						
						
						
					 
					
						2021-12-28 12:36:57 +01:00 
						 
				 
			
				
					
						
							
							
								Joel Farthing 
							
						 
					 
					
						
						
							
						
						2f14432375 
					 
					
						
						
							
							Fixed   #33128  -- Corrected possessive 's usage in FormSet docs.  
						
						
						
						
					 
					
						2021-09-22 11:26:24 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						97237ad3fe 
					 
					
						
						
							
							Removed versionadded/changed annotations for 3.2.  
						
						
						
						
					 
					
						2021-09-20 21:23:01 +02: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 
						 
				 
			
				
					
						
							
							
								Ties Jan Hefting 
							
						 
					 
					
						
						
							
						
						4f3acf9579 
					 
					
						
						
							
							Fixed   #32984  -- Allowed customizing a deletion field widget in formsets.  
						
						
						
						
					 
					
						2021-08-03 13:12:50 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						1024b5e74a 
					 
					
						
						
							
							Fixed 32956 -- Lowercased spelling of "web" and "web framework" where appropriate.  
						
						
						
						
					 
					
						2021-07-29 06:24:12 +02:00 
						 
				 
			
				
					
						
							
							
								Ties Jan Hefting 
							
						 
					 
					
						
						
							
						
						84400d2e9d 
					 
					
						
						
							
							Fixed   #32905  -- Added CSS class for non-form errors of formsets.  
						
						
						
						
					 
					
						2021-07-15 07:00:39 +02:00 
						 
				 
			
				
					
						
							
							
								Nick Pope 
							
						 
					 
					
						
						
							
						
						c156e36955 
					 
					
						
						
							
							Refs  #32720  -- Updated various links in docs to avoid redirects and use HTTPS.  
						
						
						
						
					 
					
						2021-05-17 09:46:09 +02:00 
						 
				 
			
				
					
						
							
							
								Mariusz Felisiak 
							
						 
					 
					
						
						
							
						
						d992f4e3c2 
					 
					
						
						
							
							Refs  #31369  -- Removed models.NullBooleanField per deprecation timeline.  
						
						
						
						
					 
					
						2021-01-14 17:50:04 +01:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						d3b3eb860d 
					 
					
						
						
							
							Removed forms-MAX_NUM_FORMS POST data in docs  
						
						... 
						
						
						
						The field is ignored server-side and only exists as a client-side
convenience. Removing it slightly simplifies the documentation and
avoids some distractions.
Added note:: for MIN_NUM_FORMS/MAX_NUM_FORMS in
Understanding the management form section.
Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es > 
						
						
					 
					
						2020-12-23 17:15:48 +01:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						550297d20d 
					 
					
						
						
							
							Added backticks to code literals in various docs.  
						
						
						
						
					 
					
						2020-12-15 07:19:00 +01:00 
						 
				 
			
				
					
						
							
							
								sage 
							
						 
					 
					
						
						
							
						
						4a412c2e65 
					 
					
						
						
							
							Fixed   #32199  -- Doc'd JSONField in ModelForm field mapping.  
						
						
						
						
					 
					
						2020-11-17 08:52:23 +01:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						859cd7c6b4 
					 
					
						
						
							
							Fixed   #22276  -- Fixed crash when formset  management form is invalid.  
						
						... 
						
						
						
						Co-authored-by: Patryk Zawadzki <patrys@room-303.com > 
						
						
					 
					
						2020-11-05 10:40:41 +01:00 
						 
				 
			
				
					
						
							
							
								Jon Dufresne 
							
						 
					 
					
						
						
							
						
						2b56c56653 
					 
					
						
						
							
							Corrected output of rendered formset example in model formsets docs.  
						
						
						
						
					 
					
						2020-10-26 07:38:54 +01:00 
						 
				 
			
				
					
						
							
							
								meghanabhange 
							
						 
					 
					
						
						
							
						
						848770dd2c 
					 
					
						
						
							
							Fixed   #32042  -- Improved error messages for the number of submitted forms in formsets.  
						
						
						
						
					 
					
						2020-09-28 07:05:34 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						e2e34f4de3 
					 
					
						
						
							
							Fixed   #27679  -- Doc'd that empty formsets display extra + min_num forms.  
						
						
						
						
					 
					
						2020-08-18 22:56:39 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						162765d6c3 
					 
					
						
						
							
							Fixed   #9061  -- Allowed FormSets to disable deleting extra forms.  
						
						... 
						
						
						
						Thanks to Dan Ward for the initial patch. 
						
						
					 
					
						2020-06-24 09:26:25 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						10df5b7177 
					 
					
						
						
							
							Refs  #31670  -- Removed whitelist/blacklist terminology in docs and comments.  
						
						
						
						
					 
					
						2020-06-17 13:15:56 +02:00 
						 
				 
			
				
					
						
							
							
								David Smith 
							
						 
					 
					
						
						
							
						
						433dd737f9 
					 
					
						
						
							
							Fixed   #20347  -- Allowed customizing the maximum number of instantiated forms in formsets.  
						
						... 
						
						
						
						Co-authored-by: ethurgood <ethurgood@gmail.com > 
						
						
					 
					
						2020-06-05 12:01:32 +02:00