Lightbox (JavaScript): Difference between revisions

Content deleted Content added
SchuminWeb (talk | contribs)
Functionality: Wikipedia is not a how-to...
Line 24:
While Lightbox is dependent upon a browser's compatibility with Prototype to function,<ref name="Schmitt">{{cite book | last = Schmitt | first = Christopher | year = 2006 | title = CSS Cookbook | publisher = [[O'Reilly]] | isbn = 0596527411 | pages = p. 207 }}</ref> Lightbox is triggered through a standard link tag. Thus browsers that do not support JavaScript simply load the image as a separate file, losing the Lightbox effect but still retaining the ability to display the full-sized image.<ref name="Zervaas" /> Even so, some compatibility problems have been identified with versions of Lightbox, in particular when displaying larger images on [[Firefox]] or [[Opera (web browser)|Opera]].<ref name="Campbell">{{cite web | last = Campbell | first = Debbie | date = [[February 15]], [[2007]] | title = Thickbox - For Image Display and Slideshows | work = WebProNews | url = http://www.webpronews.com/blogtalk/2007/02/15/thickbox-for-image-display-and-slideshows | accessdate = 2008-05-21 }}</ref>
 
Many users have also noted that there is a lack of compatibility across the Internet Explorer range of browsers. Even Internet Explorer 8 Beta has shown issues on some sites. However, many times the compatibility issues can be due to users not reading the documentation on how to make lightbox function correctly in these browsers .
 
 
 
See more on http://www.huddletogether.com/projects/lightbox2/
 
 
'''How to Use:'''
 
Part 1 - Setup
Lightbox 2 uses the Prototype Framework and Scriptaculous Effects Library. You will need to include these three Javascript files in your header (in this order).
 
<script type="text/javascript" src="js/prototype.js"></script>
<script type="text/javascript" src="js/scriptaculous.js?load=effects,builder"></script>
<script type="text/javascript" src="js/lightbox.js"></script>
 
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" />
 
Check the CSS and make sure the referenced prev.gif and next.gif files are in the right ___location. Also, make sure the loading.gif and close.gif files as referenced near the top of the lightbox.js file are in the right ___location.
 
 
'''Part 2 - Activate'''
 
Add a rel="lightbox" attribute to any link tag to activate the lightbox. For example:
<a href="images/image-1.jpg" rel="lightbox" title="my caption">image #1</a>
Optional: Use the title attribute if you want to show a caption.
 
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]">image #1</a>
<a href="images/image-2.jpg" rel="lightbox[roadtrip]">image #2</a>
<a href="images/image-3.jpg" rel="lightbox[roadtrip]">image #3</a>
 
No limits to the number of image sets per page or how many images are allowed in each set. Go nuts!
 
== References ==