Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Fixed #19610 - Added enctype note to forms topics doc.

Thanks will@ for the suggestion.
  • Loading branch information...
commit 0de2645c00c2330060c9889c71afd3a528ed7a3a 1 parent b44a5d1
@timgraham timgraham authored
Showing with 10 additions and 0 deletions.
  1. +2 −0  docs/ref/forms/api.txt
  2. +8 −0 docs/topics/forms/index.txt
View
2  docs/ref/forms/api.txt
@@ -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::
View
8 docs/topics/forms/index.txt
@@ -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
Please sign in to comment.
Something went wrong with that request. Please try again.