Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Fixed #5854 -- Added an example to the newforms documentation showing…

… how to

highlight required fields (which should also provide enough clues for
accessing other attributes on newforms.Field subclasses. Thanks,
christobzr@gmail.com.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@6740 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit d94ed44c5df7313bce825d17a8f3e7dff9451365 1 parent 8d29fab
@malcolmt malcolmt authored
Showing with 25 additions and 0 deletions.
  1. +1 −0  AUTHORS
  2. +24 −0 docs/newforms.txt
View
1  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 <christobzr@gmail.com>
kurtiss@meetro.com
lakin.wecker@gmail.com
Nick Lane <nick.lane.au@gmail.com>
View
24 docs/newforms.txt
@@ -753,6 +753,30 @@ For example::
</ul>
</form>
+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::
+
+ <form method="post" action="">
+ <dl>
+ {% for field in form %}
+ <dt>{{ field.label_tag }}{{ field.label }}{% if field.field.required %}*{% endif %}</dt>
+ <dd>{{ field }}</dd>
+ {% if field.help_text %}<dd>{{ field.help_text }}</dd>{% endif %}
+ {% if field.errors %}<dd class="myerrors">{{ field.errors }}</dd>{% endif %}
+ {% endfor %}
+ </dl>
+ <input type="submit" />
+ </form>
+
+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
--------------------------------
Please sign in to comment.
Something went wrong with that request. Please try again.