Animated Responsive Image Grid

A jQuery plugin for creating a responsive image grid that will switch images using different animations and timings. This can work nicely as a background or decorative element of a website since we can randomize the appearance of new images and their transitions.
Animated Responsive Image Grid

From our monthly sponsor: Create your beautiful portfolio website with Squarespace. Start your free trial.Advertisement

Today we want to share a jQuery plugin for creating a responsive image grid with you. The idea is to have a list of images and define the number of columns and rows which will arrange the images into a grid. The remaining images will appear with different animations and delays. With some sizing options we can define how the grid should be laid out for different screen widths.

This kind of component can work nicely as a background or decorative element of a website since we can randomize the appearance of new images and their transitions.

The beautiful images are by talented Sherman Geronimo-Tan and they are licensed under Creative Commons Attribution 2.0 Generic (CC BY 2.0).

The HTML structure is simply an unordered list with anchors and images:

<div id="ri-grid" class="ri-grid ri-grid-size-1 ri-shadow">
	<ul>
		<li><a href="#"><img src="images/medium/1.jpg" alt="Whatever works"/></a></li>
		<li><a href="#"><img src="images/medium/2.jpg" alt="Anything else"/></a></li>
		<!-- ... -->
	</ul>
</div>

To call the plugin, simply do:

$(function() {
			
	$( '#ri-grid' ).gridrotator();

});

Don’t forget to include the other scripts that are needed.

Options

The following options are available:

// number of rows
rows			: 4,

// number of columns 
columns			: 10,

// rows/columns for different screen widths
// i.e. w768 is for screens smaller than 768 pixels
w1024			: {
	rows	: 3,
	columns	: 8
},

w768			: {
	rows	: 3,
	columns	: 7
},

w480			: {
	rows	: 3,
	columns	: 5
},

w320			: {
	rows	: 2,
	columns	: 4
},

w240			: {
	rows	: 2,
	columns	: 3
},

// step: number of items that are replaced at the same time
// random || [some number]
// note: for performance issues, the number should not be > options.maxStep
step			: 'random',
maxStep			: 3,

// prevent user to click the items
preventClick	: true,

// animation type
// showHide || fadeInOut || slideLeft || 
// slideRight || slideTop || slideBottom || 
// rotateLeft || rotateRight || rotateTop || 
// rotateBottom || scale || rotate3d || 
// rotateLeftScale || rotateRightScale || 
// rotateTopScale || rotateBottomScale || random
animType		: 'random',

// animation speed
animSpeed		: 500,

// animation easings
animEasingOut	: 'linear',
animEasingIn	: 'linear',

// the item(s) will be replaced every 3 seconds
// note: for performance issues, the time "can't" be < 300 ms
interval		: 3000,
// if false the animations will not start
// use false if onhover is true for example
slideshow		: true,
// if true the items will switch when hovered
onhover		: false,
// ids of elements that shouldn't change
nochange		: []

When defining the size of the grid, you should keep in mind that you will want to have less images in the grid than what you actually put in the list. Let's say you have a list of 50 images and define 5 columns and 4 rows. This will create a grid of 20 images with 30 left to be switched.

Check out the five demos with different configurations:

Thanks to Jesse Chase for sending us a similar idea and inspiring us.

Hope you find this useful!

Tagged with:

ML is a freelance web designer and developer with a passion for interaction design. She studied Cognitive Science and Computational Logic and has a weakness for the smell of freshly ground peppercorns.

http://www.codrops.com

Receive our bi-weekly Collective or official newsletter right in your inbox.

CSS Reference

Learn about all important CSS properties from the basics with our extensive and easy-to-read CSS Reference.

It doesn't matter if you are a beginner or intermediate, start learning CSS now.

Feedback 115

Comments are closed.
  1. Hi ML – great script – think it will perfectly

    one question – is there a way to add white space between images?

    tried to change margins of li items but breaks grid structure

    thanks so much!

  2. Hi. This is a awsome responsive technique. I am doing a portfolio and i need the images that apear within each “li” to relate to a specific job. In this case it randoms. Can you tell me how i do this?

    Thank you in advance

  3. Hello,
    I have found an issue with your gridrotator: I have a list of images and they all rotate nicely but if I set the step to 1 then the first image of the list never changes. If I set Step to 2, the issue is gone. Any ideas?

    • I fixed the bug like that: line 20 of gridrotator now looks like this

      // Stefano Vergani – the following line fixes the bug that if step=1 the first image never changes
      p = Math.floor(Math.random()*this.length);

  4. Hi, ML I love your code and I want to get to play with it, but I’m pretty new in this so this is a stupid question.
    I m changing the pictures in the img folder same width and height as the ones in the demo and the grid it gone.
    Do I have to change something else?

  5. Having trouble with the images getting requested from the server over and over. I’m not seeing that behavior on the server.
    Any help would be greatly appreciated.

  6. Having trouble to add a lightbox pluggin in rotator pluggin . i want when we click on image it comes in a lightbox but it’s not working it is possible or not? let me know and by the way it was awesome pluggin very good effect i just loved it thanks for sharing

  7. I’m trying to achieve the same thing as the previous poster, but with fancybox.
    In firefox it just opens the link, in IE9 it opens an empty fancybox

  8. I’m unable to get this to work with JQuery 1.9+

    Below is the error I receive:

    Uncaught TypeError: Cannot read property ‘backgroundsize’ of undefined application.js:17205
    $.GridRotator application.js:17205
    (anonymous function) application.js:17845
    jQuery.extend.each application.js:649
    jQuery.fn.jQuery.each application.js:271
    $.fn.gridrotator application.js:17836
    (anonymous function) localhost/:332
    fire application.js:1038
    self.fireWith application.js:1149
    jQuery.extend.ready application.js:434
    completed

    Any help would be appreciated.

    • I’m getting the same error…. “Uncaught TypeError: Cannot read property ‘backgroundsize’ of undefined”

      Is there a fix for this? I’m using jQuery 1.8.3

  9. Hi,

    I’m trying to use your script, and wondering that is it possible to have an uneven height and width for the images. Currently, I think everything is perfectly square. How do I change it to accomodate, say, a 292px x 250px thumbs. Your help is greatly appreciated. Thanks.

  10. Hi Mari Lou, Thanks for your fantastic work “as always” … also thanks to Stefano Vergani for your input … : )

  11. He visto que es importante poner en el supuesto caso en que se utilice la versión de ancho completo

    body {
    overflow: scroll;
    overflow-x: hidden;
    }

    Para que en resoluciones mayores de 1280px se vea correctamente el grid y no pasen algunos items a una fila inferior dejando un margen derecho bastante feo.

    Excepto esto, muchísimas gracias por tan excepcional plugin ;)

  12. Hello, I do not know why, but the last line image does not appear? Why?
    Thank you for your help.

  13. Hi,
    Very useful … However, I’m trying to apply it with dynamic content where I have 25 images and I defined the rows 3 and columns 5 that would out put 15 and leave 10 to switch with…. But my only problem is that the output is giving one image yes and one image no … any Idea why this behavior is happening ???
    Thank you

  14. I’m getting an error…. “Uncaught TypeError: Cannot read property ‘backgroundsize’ of undefined”
    Is there a fix for this? I’m using jQuery 1.8.3

    • I had the similar problem, enqueing modernizer before the gridrotator script fixed it.

  15. Just a heads up that the mouse over hover animation stops working if you resize the window. Looking into why 🙂

  16. There is any way to use no-squared images without stretch them!??
    Very thanks for this great work!

  17. I spent a while trying to get an on hover script working to show the full version of the image and finally got it working.

    What I found out is that because there is a delay to load the images on to the page it is necessary to use on the script you are adding.

    $(window).load(function(){ /*code here*/ })

    I hope this others save time.