Context Navigation

Ticket #19610: 19610.diff

File 19610.diff, 1.4 KB (added by Tim Graham, 11 years ago)

diff --git a/docs/ref/forms/api.txt b/docs/ref/forms/api.txt
index 4aacbf0..d1f877f 100644

                form data *and* file data::
 Testing for multipart forms
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. method:: Form.is_multipart
 If you're writing reusable views or templates, you may not know ahead of time
 whether your form is a multipart form or not. The ``is_multipart()`` method
 tells you whether the form requires multipart encoding for submission::

diff --git a/docs/topics/forms/index.txt b/docs/topics/forms/index.txt
index 9b5794a..a3c17e1 100644

                context variable ``form``. Here's a simple example template::
 The form only outputs its own fields; it is up to you to provide the surrounding
 ``<form>`` tags and the submit button.
+If your form includes uploaded files, be sure to include
+``enctype="multipart/form-data"`` in the ``form`` element. If you wish to write
+a generic template that will work whether or not the form has files, you can
+use the :meth:`~django.forms.Form.is_multipart` attribute on the form::
+    <form action="/contact/" method="post"
+        {% if form.is_multipart %}enctype="multipart/form-data"{% endif %}>
 .. admonition:: Forms and Cross Site Request Forgery protection
    Django ships with an easy-to-use :doc:`protection against Cross Site Request