diff --git a/django/contrib/admin/media/css/widgets.css b/django/contrib/admin/media/css/widgets.css
index 620e08289a..a761a7b7b0 100644
--- a/django/contrib/admin/media/css/widgets.css
+++ b/django/contrib/admin/media/css/widgets.css
@@ -198,6 +198,13 @@ p.file-upload {
margin-left: 5px;
}
+span.clearable-file-input label {
+ color: #333;
+ font-size: 11px;
+ display: inline;
+ float: none;
+}
+
/* CALENDARS & CLOCKS */
.calendarbox, .clockbox {
diff --git a/django/contrib/admin/widgets.py b/django/contrib/admin/widgets.py
index 2c7ac5c794..eb7f217a9a 100644
--- a/django/contrib/admin/widgets.py
+++ b/django/contrib/admin/widgets.py
@@ -85,20 +85,12 @@ class AdminRadioFieldRenderer(RadioFieldRenderer):
class AdminRadioSelect(forms.RadioSelect):
renderer = AdminRadioFieldRenderer
-class AdminFileWidget(forms.FileInput):
- """
- A FileField Widget that shows its current value if it has one.
- """
- def __init__(self, attrs={}):
- super(AdminFileWidget, self).__init__(attrs)
+class AdminFileWidget(forms.ClearableFileInput):
+ template_with_initial = (u'
%s
'
+ % forms.ClearableFileInput.template_with_initial)
+ template_with_clear = (u'%s'
+ % forms.ClearableFileInput.template_with_clear)
- def render(self, name, value, attrs=None):
- output = []
- if value and hasattr(value, "url"):
- output.append('%s %s %s ' % \
- (_('Currently:'), value.url, value, _('Change:')))
- output.append(super(AdminFileWidget, self).render(name, value, attrs))
- return mark_safe(u''.join(output))
class ForeignKeyRawIdWidget(forms.TextInput):
"""
diff --git a/django/db/models/fields/files.py b/django/db/models/fields/files.py
index 6dfeddbc41..9ee523b9d5 100644
--- a/django/db/models/fields/files.py
+++ b/django/db/models/fields/files.py
@@ -282,7 +282,15 @@ class FileField(Field):
return os.path.join(self.get_directory_name(), self.get_filename(filename))
def save_form_data(self, instance, data):
- if data:
+ # Important: None means "no change", other false value means "clear"
+ # This subtle distinction (rather than a more explicit marker) is
+ # needed because we need to consume values that are also sane for a
+ # regular (non Model-) Form to find in its cleaned_data dictionary.
+ if data is not None:
+ # This value will be converted to unicode and stored in the
+ # database, so leaving False as-is is not acceptable.
+ if not data:
+ data = ''
setattr(instance, self.name, data)
def formfield(self, **kwargs):
diff --git a/django/forms/fields.py b/django/forms/fields.py
index de14a5c8a8..03455e0989 100644
--- a/django/forms/fields.py
+++ b/django/forms/fields.py
@@ -27,8 +27,9 @@ from django.core.validators import EMPTY_VALUES
from util import ErrorList
from widgets import TextInput, PasswordInput, HiddenInput, MultipleHiddenInput, \
- FileInput, CheckboxInput, Select, NullBooleanSelect, SelectMultiple, \
- DateInput, DateTimeInput, TimeInput, SplitDateTimeWidget, SplitHiddenDateTimeWidget
+ ClearableFileInput, CheckboxInput, Select, NullBooleanSelect, SelectMultiple, \
+ DateInput, DateTimeInput, TimeInput, SplitDateTimeWidget, SplitHiddenDateTimeWidget, \
+ FILE_INPUT_CONTRADICTION
__all__ = (
'Field', 'CharField', 'IntegerField',
@@ -108,6 +109,9 @@ class Field(object):
if self.localize:
widget.is_localized = True
+ # Let the widget know whether it should display as required.
+ widget.is_required = self.required
+
# Hook into self.widget_attrs() for any Field-specific HTML attributes.
extra_attrs = self.widget_attrs(widget)
if extra_attrs:
@@ -167,6 +171,17 @@ class Field(object):
self.run_validators(value)
return value
+ def bound_data(self, data, initial):
+ """
+ Return the value that should be shown for this field on render of a
+ bound form, given the submitted POST data for the field and the initial
+ data, if any.
+
+ For most fields, this will simply be data; FileFields need to handle it
+ a bit differently.
+ """
+ return data
+
def widget_attrs(self, widget):
"""
Given a Widget instance (*not* a Widget class), returns a dictionary of
@@ -434,12 +449,13 @@ class EmailField(CharField):
default_validators = [validators.validate_email]
class FileField(Field):
- widget = FileInput
+ widget = ClearableFileInput
default_error_messages = {
'invalid': _(u"No file was submitted. Check the encoding type on the form."),
'missing': _(u"No file was submitted."),
'empty': _(u"The submitted file is empty."),
'max_length': _(u'Ensure this filename has at most %(max)d characters (it has %(length)d).'),
+ 'contradiction': _(u'Please either submit a file or check the clear checkbox, not both.')
}
def __init__(self, *args, **kwargs):
@@ -468,10 +484,29 @@ class FileField(Field):
return data
def clean(self, data, initial=None):
+ # If the widget got contradictory inputs, we raise a validation error
+ if data is FILE_INPUT_CONTRADICTION:
+ raise ValidationError(self.error_messages['contradiction'])
+ # False means the field value should be cleared; further validation is
+ # not needed.
+ if data is False:
+ if not self.required:
+ return False
+ # If the field is required, clearing is not possible (the widget
+ # shouldn't return False data in that case anyway). False is not
+ # in validators.EMPTY_VALUES; if a False value makes it this far
+ # it should be validated from here on out as None (so it will be
+ # caught by the required check).
+ data = None
if not data and initial:
return initial
return super(FileField, self).clean(data)
+ def bound_data(self, data, initial):
+ if data in (None, FILE_INPUT_CONTRADICTION):
+ return initial
+ return data
+
class ImageField(FileField):
default_error_messages = {
'invalid_image': _(u"Upload a valid image. The file you uploaded was either not an image or a corrupted image."),
diff --git a/django/forms/forms.py b/django/forms/forms.py
index 13ef1a7682..0377de4767 100644
--- a/django/forms/forms.py
+++ b/django/forms/forms.py
@@ -437,10 +437,8 @@ class BoundField(StrAndUnicode):
if callable(data):
data = data()
else:
- if isinstance(self.field, FileField) and self.data is None:
- data = self.form.initial.get(self.name, self.field.initial)
- else:
- data = self.data
+ data = self.field.bound_data(
+ self.data, self.form.initial.get(self.name, self.field.initial))
data = self.field.prepare_value(data)
if not only_initial:
diff --git a/django/forms/widgets.py b/django/forms/widgets.py
index 2e16c35d8b..cb12586d6c 100644
--- a/django/forms/widgets.py
+++ b/django/forms/widgets.py
@@ -7,7 +7,7 @@ from itertools import chain
from django.conf import settings
from django.utils.datastructures import MultiValueDict, MergeDict
from django.utils.html import escape, conditional_escape
-from django.utils.translation import ugettext
+from django.utils.translation import ugettext, ugettext_lazy
from django.utils.encoding import StrAndUnicode, force_unicode
from django.utils.safestring import mark_safe
from django.utils import datetime_safe, formats
@@ -18,7 +18,7 @@ from urlparse import urljoin
__all__ = (
'Media', 'MediaDefiningClass', 'Widget', 'TextInput', 'PasswordInput',
- 'HiddenInput', 'MultipleHiddenInput',
+ 'HiddenInput', 'MultipleHiddenInput', 'ClearableFileInput',
'FileInput', 'DateInput', 'DateTimeInput', 'TimeInput', 'Textarea', 'CheckboxInput',
'Select', 'NullBooleanSelect', 'SelectMultiple', 'RadioSelect',
'CheckboxSelectMultiple', 'MultiWidget',
@@ -134,6 +134,7 @@ class Widget(object):
is_hidden = False # Determines whether this corresponds to an .
needs_multipart_form = False # Determines does this widget need multipart-encrypted form
is_localized = False
+ is_required = False
def __init__(self, attrs=None):
if attrs is not None:
@@ -286,6 +287,67 @@ class FileInput(Input):
return False
return True
+FILE_INPUT_CONTRADICTION = object()
+
+class ClearableFileInput(FileInput):
+ initial_text = ugettext_lazy('Currently')
+ input_text = ugettext_lazy('Change')
+ clear_checkbox_label = ugettext_lazy('Clear')
+
+ template_with_initial = u'%(initial_text)s: %(initial)s %(clear_template)s %(input_text)s: %(input)s'
+
+ template_with_clear = u'%(clear)s '
+
+ def clear_checkbox_name(self, name):
+ """
+ Given the name of the file input, return the name of the clear checkbox
+ input.
+ """
+ return name + '-clear'
+
+ def clear_checkbox_id(self, name):
+ """
+ Given the name of the clear checkbox input, return the HTML id for it.
+ """
+ return name + '_id'
+
+ def render(self, name, value, attrs=None):
+ substitutions = {
+ 'initial_text': self.initial_text,
+ 'input_text': self.input_text,
+ 'clear_template': '',
+ 'clear_checkbox_label': self.clear_checkbox_label,
+ }
+ template = u'%(input)s'
+ substitutions['input'] = super(ClearableFileInput, self).render(name, value, attrs)
+
+ if value and hasattr(value, "url"):
+ template = self.template_with_initial
+ substitutions['initial'] = (u'%s'
+ % (value.url, value))
+ if not self.is_required:
+ checkbox_name = self.clear_checkbox_name(name)
+ checkbox_id = self.clear_checkbox_id(checkbox_name)
+ substitutions['clear_checkbox_name'] = checkbox_name
+ substitutions['clear_checkbox_id'] = checkbox_id
+ substitutions['clear'] = CheckboxInput().render(checkbox_name, False, attrs={'id': checkbox_id})
+ substitutions['clear_template'] = self.template_with_clear % substitutions
+
+ return mark_safe(template % substitutions)
+
+ def value_from_datadict(self, data, files, name):
+ upload = super(ClearableFileInput, self).value_from_datadict(data, files, name)
+ if not self.is_required and CheckboxInput().value_from_datadict(
+ data, files, self.clear_checkbox_name(name)):
+ if upload:
+ # If the user contradicts themselves (uploads a new file AND
+ # checks the "clear" checkbox), we return a unique marker
+ # object that FileField will turn into a ValidationError.
+ return FILE_INPUT_CONTRADICTION
+ # False signals to clear any existing value, as opposed to just None
+ return False
+ return upload
+
class Textarea(Widget):
def __init__(self, attrs=None):
# The 'rows' and 'cols' attributes are required for HTML correctness.
diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index 0dd9095a77..d2b1c303ed 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -507,7 +507,7 @@ given length.
.. class:: FileField(**kwargs)
- * Default widget: ``FileInput``
+ * Default widget: ``ClearableFileInput``
* Empty value: ``None``
* Normalizes to: An ``UploadedFile`` object that wraps the file content
and file name into a single object.
@@ -573,7 +573,7 @@ These control the range of values permitted in the field.
.. class:: ImageField(**kwargs)
- * Default widget: ``FileInput``
+ * Default widget: ``ClearableFileInput``
* Empty value: ``None``
* Normalizes to: An ``UploadedFile`` object that wraps the file content
and file name into a single object.
diff --git a/docs/ref/forms/widgets.txt b/docs/ref/forms/widgets.txt
index 05215d4d8e..c01a7368bd 100644
--- a/docs/ref/forms/widgets.txt
+++ b/docs/ref/forms/widgets.txt
@@ -46,6 +46,14 @@ commonly used groups of widgets:
File upload input: ````
+.. class:: ClearableFileInput
+
+ .. versionadded:: 1.3
+
+ File upload input: ````, with an additional checkbox
+ input to clear the field's value, if the field is not required and has
+ initial data.
+
.. class:: DateInput
.. versionadded:: 1.1
diff --git a/docs/releases/1.3.txt b/docs/releases/1.3.txt
index 51de6fdd92..aaee5d8ef2 100644
--- a/docs/releases/1.3.txt
+++ b/docs/releases/1.3.txt
@@ -42,6 +42,31 @@ custom widget to your form that sets the ``render_value`` argument::
username = forms.CharField(max_length=100)
password = forms.PasswordField(widget=forms.PasswordInput(render_value=True))
+Clearable default widget for FileField
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Django 1.3 now includes a ``ClearableFileInput`` form widget in addition to
+``FileInput``. ``ClearableFileInput`` renders with a checkbox to clear the
+field's value (if the field has a value and is not required); ``FileInput``
+provided no means for clearing an existing file from a ``FileField``.
+
+``ClearableFileInput`` is now the default widget for a ``FileField``, so
+existing forms including ``FileField`` without assigning a custom widget will
+need to account for the possible extra checkbox in the rendered form output.
+
+To return to the previous rendering (without the ability to clear the
+``FileField``), use the ``FileInput`` widget in place of
+``ClearableFileInput``. For instance, in a ``ModelForm`` for a hypothetical
+``Document`` model with a ``FileField`` named ``document``::
+
+ from django import forms
+ from myapp.models import Document
+
+ class DocumentForm(forms.ModelForm):
+ class Meta:
+ model = Document
+ widgets = {'document': forms.FileInput}
+
.. _deprecated-features-1.3:
Features deprecated in 1.3
diff --git a/tests/regressiontests/admin_widgets/models.py b/tests/regressiontests/admin_widgets/models.py
index 59d625ba12..20c0df6ee8 100644
--- a/tests/regressiontests/admin_widgets/models.py
+++ b/tests/regressiontests/admin_widgets/models.py
@@ -116,7 +116,7 @@ HTML escaped.
>>> w = AdminFileWidget()
>>> print conditional_escape(w.render('test', album.cover_art))
-Currently: albums\hybrid_theory.jpg Change:
+