Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

[1.5.x] Documented BoundField.label_tag

Backport of 0f99246 from master.
  • Loading branch information...
commit 991432ee8ab49eca76113f0b6c23e885ea316507 1 parent 709ee83
@claudep claudep authored
Showing with 13 additions and 0 deletions.
  1. +13 −0 docs/ref/forms/api.txt
View
13 docs/ref/forms/api.txt
@@ -638,6 +638,19 @@ For a field's list of errors, access the field's ``errors`` attribute.
>>> str(f['subject'].errors)
''
+.. method:: BoundField.label_tag(contents=None, attrs=None)
+
+To separately render the label tag of a form field, you can call its
+``label_tag`` method::
+
+ >>> f = ContactForm(data)
+ >>> print(f['message'].label_tag())
+ <label for="id_message">Message</label>
+
+Optionally, you can provide the ``contents`` parameter which will replace the
+auto-generated label tag. An optional ``attrs`` dictionary may contain
+additional attributes for the ``<label>`` tag.
+
.. method:: BoundField.css_classes()
When you use Django's rendering shortcuts, CSS classes are used to
Please sign in to comment.
Something went wrong with that request. Please try again.