Opened 10 years ago
Last modified 10 years ago
#25481 closed Cleanup/optimization
Documentation: Add field.help_text to looping over a form's fields — at Initial Version
| Reported by: | Wim Feijen | Owned by: | nobody |
|---|---|---|---|
| Component: | Documentation | Version: | dev |
| Severity: | Normal | Keywords: | |
| Cc: | Triage Stage: | Accepted | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | yes | UI/UX: | no |
Description
On https://docs.djangoproject.com/en/dev/topics/forms/#looping-over-the-form-s-fields
the example of looping over the form's fields omits {{ field.help_text }}, though this field is outputted by default by {{ form.as_ul }}. I believe we should add {{ field.help_text }} in the example to be both consistent and complete.
In addition, but not related, {{ field.errors }} might need a span for the example to be usable in real life.
From the docs:
---
Looping over the form’s fields¶
If you’re using the same HTML for each of your form fields, you can reduce duplicate code by looping through each field in turn using a {% for %} loop:
{% for field in form %}
<div class="fieldWrapper">
{{ field.errors }}
{{ field.label_tag }} {{ field }}
</div>
{% endfor %}
{% for field in form %}
<div class="fieldWrapper">
{{ field.errors }}
{{ field.label_tag }} {{ field }}
</div>
{% endfor %}