Lightbox JS v2.0

by Lokesh Dhakar | autoFireLightbox functionality by Bramus!

Demo not working? Then make sure you're viewing this page via index.html#image001 ;)

Example

This page is a testpage of the autoFireLightbox functionality - see http://www.bram.us/2007/07/30/my-code-snippet-automatically-start-lightbox-on-page-load/ for details

How to Use (modified for autoFireLightbox):

Part 1 - Setup

1. Lightbox v2.0 uses the Prototype Framework and Scriptaculous Effects Library. You will need to include these three Javascript files in your header.

   <script type="text/javascript" src="js/prototype.js"></script>
   <script type="text/javascript" src="js/scriptaculous.js?load=effects"></script>
   <script type="text/javascript" src="js/lightbox.js"></script>
   
   <script type="text/javascript">
   	// <![CDATA[
   		// Automagically load Lightbox on Page Load - by Bramus! (http://www.bram.us/)
   		// Code modded from http://www.huddletogether.com/forum/comments.php?DiscussionID=1269&page=1#Item_0
   		function autoFireLightbox() {
   			//Check if location.hash matches a lightbox-anchor. If so, trigger popup of image.
   			setTimeout(function() {
   				if(document.location.hash && $(document.location.hash.substr(1)).rel.indexOf('lightbox')!=-1) {
   					myLightbox.start($(document.location.hash.substr(1)));
   				}},
   				250
   			);
   		}
   		Event.observe(window, 'load', autoFireLightbox, false);
   	// ]]>
   </script>
   
   

2. Include the Lightbox CSS file (or append your active stylesheet with the Lightbox styles).

   <link rel="stylesheet" href="css/lightbox.css" type="text/css" media="screen" />
   

3. Check the CSS and make sure the referenced prevlabel.gif and nextlabel.gif files are in the right location. Also, make sure the loading.gif and closelabel.gif files as referenced near the top of the lightbox.js file are in the right location.

Part 2 - Activate

1. Add a rel="lightbox" attribute to any link tag to activate the lightbox and give it an id. For example:

   <a href="images/image-1.jpg" rel="lightbox" id="image001" title="my caption">image #1</a>
   

   Optional: Use the title attribute if you want to show a caption.
2. If you have a set of related images that you would like to group, follow step one but additionally include a group name between square brackets in the rel attribute. For example:

   <a href="images/image-1.jpg" rel="lightbox[roadtrip]" id="image001" >image #1</a>
   <a href="images/image-2.jpg" rel="lightbox[roadtrip]" id="image002" >image #2</a>
   <a href="images/image-3.jpg" rel="lightbox[roadtrip]" id="image003" >image #3</a>
   

   No limits to the number of image sets per page or how many images are allowed in each set. Go nuts!

Part 3 - Load it

1. Call your page by loading it via yourpage.html#idofthelink (example)