summaryrefslogtreecommitdiff
path: root/docs/releases
diff options
context:
space:
mode:
authorCarlton Gibson <carlton.gibson@noumenal.es>2022-04-26 16:01:59 +0200
committerCarlton Gibson <carlton.gibson@noumenal.es>2022-04-27 10:21:04 +0200
commit476d4d508717977101bba1a7f765653e48e88e76 (patch)
tree239da180ce3d0586406d3d1b36b5657bd40447a5 /docs/releases
parent832096478cf37b911688d061281348f74bf09e93 (diff)
Refs #32339 -- Allowed renderer to specify default form and formset templates.
Co-authored-by: David Smith <smithdc@gmail.com>
Diffstat (limited to 'docs/releases')
-rw-r--r--docs/releases/4.1.txt14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/releases/4.1.txt b/docs/releases/4.1.txt
index b564a325a9..4cad556dc3 100644
--- a/docs/releases/4.1.txt
+++ b/docs/releases/4.1.txt
@@ -244,6 +244,20 @@ File Uploads
Forms
~~~~~
+* The default template used to render forms when cast to a string, e.g. in
+ templates as ``{{ form }}``, is now configurable at the project-level by
+ setting :attr:`~django.forms.renderers.BaseRenderer.form_template_name` on
+ the class provided for :setting:`FORM_RENDERER`.
+
+ :attr:`.Form.template_name` is now a property deferring to the renderer, but
+ may be overridden with a string value to specify the template name per-form
+ class.
+
+ Similarly, the default template used to render formsets can be specified via
+ the matching
+ :attr:`~django.forms.renderers.BaseRenderer.formset_template_name` renderer
+ attribute.
+
* The new :meth:`~django.forms.BoundField.legend_tag` allows rendering field
labels in ``<legend>`` tags via the new ``tag`` argument of
:meth:`~django.forms.BoundField.label_tag`.