Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Automatically add dimension attributes to all <img> tags in a response to improve rendering speed on the client
Python
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
imagedimensions
.gitignore
README.rst
setup.py

README.rst

django-image-dimensions

Automatically add dimension attributes to all &lt;img&gt; tags in a response to improve rendering speed on the client.

Rationale

Specifying image dimensions in HTML improves both percieved and actual client-side rendering performance by preventing reflow. However, maintaining explicit dimensions in templates is tedious and impractical in some cases. This middleware solves that in a plug-and-play manner by automatically setting dimensions in all &amp;img&amp; tags in a response.

Requirements

  • django-celery to run image fetch and dimensions calculations in the background
  • PIL
  • A cache that is shared between web server and celery (e.g. memcached)

Installation

  1. Run pip install django-image-dimensions
  2. Add 'imagedimensions' app to INSTALLED_APPS

Usage

For a quick test-drive add 'imagedimensions.middleware.ImageDimensionsMiddleware' to MIDDLEWARE_CLASSES. However, this is not suitable for production use as it adds an overhead to every request. For production, replace {% load cache %} in your templates with {% load imgdimensions %}.

Something went wrong with that request. Please try again.