From 416a8580232075d569cf3c386a97067884c67a60 Mon Sep 17 00:00:00 2001
From: Anubhav Joshi <anubhav9042@gmail.com>
Date: Mon, 3 Mar 2014 23:29:03 +0530
Subject: Fixed #17922 -- Added required_css_class to form label.

Thanks hanson2010 for the suggestion.
---
 docs/ref/forms/api.txt | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

(limited to 'docs/ref/forms')

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
-- 
cgit v1.3