Fixed #17922 -- Added required_css_class to form label.

Thanks hanson2010 for the suggestion.

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