Create image gallery in 4 lines of jQuery

Few days ago friend asked me to build image gallery with thumbnails for her web page. Request was pretty simple, she wanted large image and few thumbnails bellow that. Also, large image should have bar with description. When user click on thumb large image and description should change.

gallery-4-lines

My idea was to use alt tag of thumb image for large image description. I already did that for jqFancyTransitions. Also, I was impatient to use jQuery’s delegate method in real life. So this is my image gallery with thumbs and description in 4 lines of jQuery.

First prepare images for gallery, large images and thumbs. We need some naming convention so let’s naming large images with suffix _large and their thumbs with suffix _thumbs. For every image we will have pair, image_xx_large.jpg and image_xx_thumb.jpg. In this example all large images will be 565x280px and thumbs will be 100x100px.

Next thing is to include jQuery in head of your document:

<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script>

After that we need layout to hold one large image and all thumbs. We need one panel with large image and description bar. Also, we need holder for thumbnails.

<div id="gallery">
	<div id="panel">
		<img id="largeImage" src="images/image_01_large.jpg" />
		<div id="description">First image description</div>
	</div>

	<div id="thumbs">
        <img src="images/image_01_thumb.jpg" alt="1st image description" />
        <img src="images/image_02_thumb.jpg" alt="2nd image description" />
        <img src="images/image_03_thumb.jpg" alt="3rd image description" />
        <img src="images/image_04_thumb.jpg" alt="4th image description" />
        <img src="images/image_05_thumb.jpg" alt="5th image description" />
	</div>
</div>

We should add some style to our gallery:

#thumbs { padding-top: 10px; overflow: hidden; }
#thumbs img, #largeImage {
   border: 1px solid gray;
   padding: 4px;
   background-color: white;
   cursor: pointer;
}
#thumbs img {
   float: left;
   margin-right: 6px;
}
#description {
   background: black;
   color: white;
   position: absolute;
   bottom: 0;
   padding: 10px 20px;
   width: 525px;
   margin: 5px;
}
#panel { 
    position: relative; 
}

Now, when we have layout and CSS prepared we should add functionality to our image gallery. When user click on thumb, large image should be changed as well as description. We will replace ‘thumb’ to ‘large’ in src attribute of largeImage and use alt attribute of thumb for description. That can be achieved with following jQuery code:

$('#thumbs img').click(function(){
    $('#largeImage').attr('src',$(this).attr('src').replace('thumb','large'));
    $('#description').html($(this).attr('alt'));
});

And that’s it, you have fully functional image gallery for your site.

The better way for this is to use delegate method of jQuery. With delegate you’ll be able to dynamically load thumbs and use them without bind event listeners for new thumbs.

$('#thumbs').delegate('img','click', function(){
    $('#largeImage').attr('src',$(this).attr('src').replace('thumb','large'));
    $('#description').html($(this).attr('alt'));
});

Delegate method is added in jQuery 1.4.2. Check more about delegate().

  • Image gallery in 4 lines of code with MooTools and Dojo (8)
    Recently I wrote article how to create image gallery with description in 4 lines of jQuery code. Now, I will do the same thing with two other popular JavaScript frameworks, MooTools and […]
  • Bigshark – larger buttons on Grooveshark (1)
    GrooveShark is one of the web services which I’m using on daily basis. Actually, I have one computer which I use only to play music from my GrooveShark playlists, while I’m sitting on […]
  • Animated Progress Bar in 4 lines of jQuery (48)
    Progress bars are really useful to indicate to user that something happens and when it will be approximately done. They are useful on page where assets should be preloaded before page is […]
  • News Ticker in 4 lines of jQuery (92)
    There are a lot of different jQuery News Ticker plugins with lot of options that you can use. Do you want to learn how to create one on your own in only 4 lines of jQuery code […]
  • Coin Slider: Image Slider with Unique Effects (1620)
    After jqFancyTransitions I decided to release new jQuery image slider plugin with more unique transitions effects. I have ideas for new effects and after I didn't find that somebody […]

140 comments on "Create image gallery in 4 lines of jQuery"

Great tutorial but is there any way to have them sideways?

Colchester Printers on December 14, 2011 at 4:30 pm

Hello!

Is there a way to have the image description to sit below the image?

Great tutorial by the way…!

chris d on November 23, 2011 at 8:26 am

this code saved my night!

thanks.

Renni on November 21, 2011 at 5:40 pm

Great. Pretty simple and to-the-point coding. Thanks.

By the way, can we add a navigation option just below the large image so that it can be used as a slider. Someone…?

Manish on November 3, 2011 at 7:53 am

Good God man thank you for this simple morsel

chris reid on October 13, 2011 at 1:43 pm

it’s so nice ! thank you

Adonice Web Design Group on October 6, 2011 at 4:31 am

[code]<a href="" rel="nofollow">

</a>
[/code]
within the html place the image in the like above.
[code]
var link = $(this).attr(‘data-id’);
$(".targetLink").attr(‘href’,link);
[/code]
within the gallery jquery add these two lines under the forth line.It should look like this:
[code]
$(document).ready(function(){
$(‘#thumbs img’).click(function(){
$(‘#largeImage’).attr(‘src’,$(this).attr(‘src’).replace(‘thumb’,’large’));
$(‘#description’).html($(this).attr(‘alt’));
var link = $(this).attr(‘data-id’);
$(".targetLink").attr(‘href’,link);
});
});
[/code]
the first 4 lines are the ones provided above and the last 2 are the ones that you add

Andrew B. on August 22, 2011 at 8:10 pm

Hi – Is there a way to put a link into the code so that when you click on each large image it can go to another page on the site?

This will help me with a site that needs to be useful for dialup users.

Warm regards,
Marge d’Wylde

Marge d'Wylde on July 23, 2011 at 1:37 pm

Thank you! Very useful!

Catalin on July 8, 2011 at 3:35 pm

Leave a Reply

Your email address will not be published. Required fields are marked *