From b2534bfa7b3b4f9d5e6c4db48556d2ae6ba3b4a9 Mon Sep 17 00:00:00 2001
From: nmundar <neven.mundar@dobarkod.hr>
Date: Sat, 15 Nov 2014 13:29:16 +0100
Subject: [1.7.x] Fixed #23690 - fixed examples of manual rendering of form
 fields

Documentation for rendering form fields manually is now updated to use fields id_for_label instead of hardcoded values with additional mention of label_tag for alternative generation of complete label tag.

Backport of 48515ee1f7bec437544a0a958332483298f4028b from master
---
 docs/topics/forms/index.txt | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/docs/topics/forms/index.txt b/docs/topics/forms/index.txt
index 7eaf346b5c..319084a0f1 100644
--- a/docs/topics/forms/index.txt
+++ b/docs/topics/forms/index.txt
@@ -535,25 +535,37 @@ in a Django template, will be rendered appropriately. For example:
     {{ form.non_field_errors }}
     <div class="fieldWrapper">
         {{ form.subject.errors }}
-        <label for="id_subject">Email subject:</label>
+        <label for="{{ form.subject.id_for_label }}">Email subject:</label>
         {{ form.subject }}
     </div>
     <div class="fieldWrapper">
         {{ form.message.errors }}
-        <label for="id_message">Your message:</label>
+        <label for="{{ form.message.id_for_label }}">Your message:</label>
         {{ form.message }}
     </div>
     <div class="fieldWrapper">
         {{ form.sender.errors }}
-        <label for="id_sender">Your email address:</label>
+        <label for="{{ form.sender.id_for_label }}">Your email address:</label>
         {{ form.sender }}
     </div>
     <div class="fieldWrapper">
         {{ form.cc_myself.errors }}
-        <label for="id_cc_myself">CC yourself?</label>
+        <label for="{{ form.cc_myself.id_for_label }}">CC yourself?</label>
         {{ form.cc_myself }}
     </div>
 
+Complete ``<label>`` element can also be generated using the
+:meth:`~django.forms.BoundField.label_tag`. For example:
+
+.. code-block:: html+django
+
+    <div class="fieldWrapper">
+        {{ form.subject.errors }}
+        {{ form.subject.label_tag }}
+        {{ form.subject }}
+    </div>
+
+
 Rendering form error messages
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-- 
cgit v1.3