diff options
| author | Malcolm Tredinnick <malcolm.tredinnick@gmail.com> | 2007-11-29 17:30:01 +0000 |
|---|---|---|
| committer | Malcolm Tredinnick <malcolm.tredinnick@gmail.com> | 2007-11-29 17:30:01 +0000 |
| commit | d94ed44c5df7313bce825d17a8f3e7dff9451365 (patch) | |
| tree | 45e2cc365ddc6b0a6fdebfaafe1837543ab29b13 | |
| parent | 8d29fabe31107b627be01be7350a72b33573ba9d (diff) | |
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
| -rw-r--r-- | AUTHORS | 1 | ||||
| -rw-r--r-- | docs/newforms.txt | 24 |
2 files changed, 25 insertions, 0 deletions
@@ -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> 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:: </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 -------------------------------- |