Ticket #4232: newforms.diff

newforms.txt

@@ -573 +573 @@
     >>> str(f['subject'].errors)
     ''
 
+In the templates
+----------------
+
+With the above example, lets put this into a view and show how you can use these
+parts from the template designer's point of view. Assuming you start with a view like:
+
+    def contact(request):
+        form = ContactForm()
+                if request.POST:
+                        new_data = request.POST.copy()
+            form = ContactForm(new_data)
+            if form.is_valid():
+                # do form processing here...
+        return render_to_response('contact.html', {'form': form})
+
+Then you can have a simple template that uses the shortcuts for form.as_ul, form.as_p, or form.as_table. An example ``contact.html`` template::
+
+    <form method="POST">
+    {{ form }}
+    </form>
+
+or
+
+    <form method="POST">
+    {{ form.as_table }}
+    </form>
+
+If you wanted to work with the individual inputs of the form, you can either call out the fields directly, or iterate over them:
+
+    <form method="POST">
+    <dl>
+    {% for field in form %}
+        <dt>{{ field.label }}</dt>
+        <dd>{{ field }}</dd>
+        <dd>{{ field.help_text }}</dd>
+        {% if field.errors %}<dd class="myerrors">{{ field.errors }}</dd>{% endif %}
+    {% endfor %}
+        </dl>
+    </form>
+
+Alternately:
+
+        <form method="POST">
+        <ul class="myformclass">
+            <li>{{ form.sender.label }} {{ form.sender.label }}</li>
+            <li class="helptext" >{{ form.sender.help_text }}</li>
+            {% if form.sender.errors %}<ul class="errorlist">{{ form.sender.errors }}</dd>{% endif %}
+
+            <li>{{ form.subject.label }} {{ form.subject.label }}</li>
+            <li class="helptext" >{{ form.subject.help_text }}</li>
+            {% if form.subject.errors %}<ul class="errorlist">{{ form.subject.errors }}</dd>{% endif %}
+
+                ...
+        </ul>
+        </form>
+
+
 Subclassing forms
 -----------------