django-sticky-uploads is a progressively enhanced file input widget for Django which uploads the file in the background and also retains value on form errors.
django-sticky-uploads requires requires Django 1.11 or 2.0, and a Python that is supported by the chosen version of Django.
The easiest way to install django-sticky-uploads is using pip:
pip install django-sticky-uploads
This project makes use of progressive enhancement meaning that while all browsers are supported, they will not all have the same user-experience. If the browser does not support the necessary client-side features then it will fall back to the default file upload behavior.
The primary HTML5 dependencies are File API and XHR2 meaning that the following desktop/mobile browsers should get the enhanced experience:
- Chrome 13+
- Firefox 4+
- Internet Explorer 10+
- Safari 6+
- Opera 12+
- iOS Safari 6+
- Android Brower 3+
- Blackberry Broswer 10+
- Opera Mobile 12+
- Chrome for Android 27+
- Firefox for Android 22+
Additional documentation on using django-sticky-uploads is available on Read The Docs.
You can run the tests with via:
tox
(Possibly after installing tox with pip install tox or alternative.)
django-sticky-uploads is released under the BSD License. See the LICENSE file for more details.
If you think you've found a bug or are interested in contributing to this project check out django-sticky-uploads on Github.
Development sponsored by Caktus Consulting Group, LLC.