Opened 9 years ago
Last modified 9 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 %}