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: [PATCH] [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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^