Commit 2e6b0c5c authored by Tim Graham's avatar Tim Graham
Browse files

[1.5.x] Fixed #19610 - Added enctype note to forms topics doc.

Thanks will@ for the suggestion.

Backport of 0de2645c from master
parent f4132140
Loading
Loading
Loading
Loading
+2 −0
Original line number Diff line number Diff line
@@ -716,6 +716,8 @@ 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::
+8 −0
Original line number Diff line number Diff line
@@ -197,6 +197,14 @@ 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