summaryrefslogtreecommitdiff
path: root/docs/ref/forms
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref/forms')
-rw-r--r--docs/ref/forms/api.txt19
1 files changed, 16 insertions, 3 deletions
diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt
index cb6cf7a51b..53e47ed0c2 100644
--- a/docs/ref/forms/api.txt
+++ b/docs/ref/forms/api.txt
@@ -511,10 +511,19 @@ classes, as needed. The HTML will look something like::
>>> f = ContactForm(data)
>>> print(f.as_table())
- <tr class="required"><th><label for="id_subject">Subject:</label> ...
- <tr class="required"><th><label for="id_message">Message:</label> ...
- <tr class="required error"><th><label for="id_sender">Sender:</label> ...
+ <tr class="required"><th><label class="required" for="id_subject">Subject:</label> ...
+ <tr class="required"><th><label class="required" for="id_message">Message:</label> ...
+ <tr class="required error"><th><label class="required" for="id_sender">Sender:</label> ...
<tr><th><label for="id_cc_myself">Cc myself:<label> ...
+ >>> f['subject'].label_tag()
+ <label class="required" for="id_subject">Subject:</label>
+ >>> f['subject'].label_tag(attrs={'class': 'foo'})
+ <label for="id_subject" class="foo required">Subject:</label>
+
+.. versionchanged:: 1.8
+
+ The ``required_css_class`` will also be added to the ``<label>`` tag as
+ seen above.
.. _ref-forms-api-configuring-label:
@@ -799,6 +808,10 @@ additional attributes for the ``<label>`` tag.
template, you could write a custom filter to allow passing parameters to
``label_tag``.
+.. versionchanged:: 1.8
+
+ The label includes :attr:`~Form.required_css_class` if applicable.
+
.. method:: BoundField.css_classes()
When you use Django's rendering shortcuts, CSS classes are used to