diff --git a/AUTHORS b/AUTHORS index 1625d820d4..f393dc7ab0 100644 --- a/AUTHORS +++ b/AUTHORS @@ -188,6 +188,7 @@ answer newbie questions, and generally made Django that much better: krzysiek.pawlik@silvermedia.pl Joseph Kocherhans konrad@gwu.edu + knox kurtiss@meetro.com lakin.wecker@gmail.com Nick Lane diff --git a/docs/newforms.txt b/docs/newforms.txt index 5feb2e6a02..810982d788 100644 --- a/docs/newforms.txt +++ b/docs/newforms.txt @@ -753,6 +753,30 @@ For example:: +Highlighting required fields in templates +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You may wish to show a visitor which fields are required. Here is the above +example modified to insert an asterix after the label of each required field:: + +
+
+ {% for field in form %} +
{{ field.label_tag }}{{ field.label }}{% if field.field.required %}*{% endif %}
+
{{ field }}
+ {% if field.help_text %}
{{ field.help_text }}
{% endif %} + {% if field.errors %}
{{ field.errors }}
{% endif %} + {% endfor %} +
+ +
+ +The ``{% if field.field.required %}*{% endif %}`` fragment is the relevant +addition here. It adds the asterix only if the field is required. Note that we +check ``field.field.required`` and not ``field.required``. In the template, +``field`` is a ``newforms.forms.BoundField`` instance, which holds the actual +``Field`` instance in its ``field`` attribute. + Binding uploaded files to a form --------------------------------