Released under the MIT License. Source on Github (changelog). Compatible with jQuery 1.7.0+ in Firefox, Safari, Chrome, Opera, Internet Explorer 7+. No dependencies except the jQuery library. A vanilla JavaScript version is available, which works down to IE8.
This plugin was developed by and for Pixabay.com - an international repository for free Public Domain images. We have implemented this plugin in production and we share this piece of software - in the spirit of Pixabay - freely with others.
Include the stylesheet jquery.flex-images.css in the <head> section of your HTML document - and the JavaScript file jquery.flex-images.min.js after loading jQuery. flexImages accepts settings from an object of key/value pairs.
$(selector).flexImages({key1: value1, key2: value2});
To update any settings or to reload modified content, simply re-initialize flexImages again on the appropriate container. The plugin automatically prevents multiple bindings to one and the same element. This may be used for content that gets modified later on via AJAX.
| Property | Default | Description |
|---|---|---|
| container | '.item' | Selector of the individual image/object containers. |
| object | 'img' | Selector of the image/object inside a container. |
| rowHeight | 180 | Maximum height of a row. |
| maxRows | null | Maximum number of rows to display. Images/Objects exceeding this row are hidden. |
| truncate | false | Hide incomplete last row of images/objects. |
HTML Markup
<div class="flex-images">
<div class="item" data-w="200" data-h="150"><img src="image1.jpg"></div>
<div class="item" data-w="250" data-h="150"><img src="image2.jpg"></div>
<div class="item" data-w="150" data-h="150"><img src="image3.jpg"></div>
<div class="item" data-w="150" data-h="150"><img src="image4.jpg"></div>
<div class="item" data-w="200" data-h="150"><img src="image5.jpg"></div>
<div class="item" data-w="100" data-h="150"><img src="image6.jpg"></div>
<div class="item" data-w="180" data-h="150"><img src="image7.jpg"></div>
<div class="item" data-w="185" data-h="150"><img src="image8.jpg"></div>
<div class="item" data-w="350" data-h="150"><img src="image9.jpg"></div>
<div class="item" data-w="200" data-h="150"><img src="image10.jpg"></div>
<div class="item" data-w="165" data-h="150"><img src="image11.jpg"></div>
<div class="item" data-w="150" data-h="150"><img src="image12.jpg"></div>
<div class="item" data-w="120" data-h="150"><img src="image13.jpg"></div>
<div class="item" data-w="120" data-h="150"><img src="image14.jpg"></div>
</div>
Each image must be wrapped inside a container element. The container must have a width (data-w) and height (data-h) attribute set that corresponds to the image's/object's original dimension.
JavaScript code
$('.flex-images').flexImages({rowHeight: 140});
How it works: The plugin dynamically changes the width and height of all containers. The images themselves have their height and width set to 100%. Thus, each image takes up the full space inside its container.
This architecture enables a very flexible grid layout that works with more than just images. E.g. objects may be placed on top of the images via absolute positioning. Or instead of images, the containers may be filled with videos or even plain text.
Please take a look at the source code of this page to see how these demos work.
1. Fixed number of two complete rows with lazy loading of images; only images that are actually visible are retrieved from the server:
For lazy loading of images or iframes, it's required to use a "blank.gif" pixel as the source of all images. The actual source URL must be given in a data-src attribute of the image. On init, the plugin will replace the dummy src attribute (blank.gif) with the actual source URL for all visible images.
2. A fluid grid with video content and only full rows:
3. Showing a title underneath + less margin between images:
4. Overlaying caption - could be a link or a button, as well:
5. Cut off parts of the images, e.g. a Shutterstock ID:
Original (uncut) first image with Shutterstock ID at the bottom:
This plugin is used in production on Pixabay.com, where you can see flexImages at work in various locations and with all available options. Please report any bugs and issues at the GitHub repositiory.
This software is released as Open Source under the MIT License by Simon Steinberger / Pixabay.com.