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 %}

Change History (0)

Note: See TracTickets for help on using tickets.
Back to Top