pagetitle: Sexy Lightbox
-
tagline: An attractive lightbox jquery plugin.
-
menu:
-
content: Installation
Upload all Sexy LightBox 2 files to your host. The images, CSS and Javascript, if you locate the images folder in a different directory you should change the path in the “dir” parameter in the class.
Write the following code between the HEAD tag in your page:
Atention: To save bandwidth, you can use the compressed version of SexyLightBox, you should to include the file “sexylightboxv.2.3.jquery.min.js”
Finally, add the following code just below of the last lines:
How to use?
To use Sexy Lightbox 2 is easy! just add the property rel=”sexylightbox” to your links:
Optional: Use the “title” property if you want to show a description for the image.
The keyword “sexylightbox” can be changed with the “find” property. Read the section General config to learn how to do it.
If you want to create a galery from a links group, you should include the gallery name between brackets in the property “rel”:
There is no limit in the galeries quantity.
There are 3 ways to show HTML content in the lightbox:
AJAX
This is the default way. Parameters “width” & “height” are required:
The following code will not work:
The correct way is specifying the height and width:
Iframe
Besides the “width” and “height” you should pass the parameter “TB_iframe”:
Inline
The link should start with “#TB_inline?inlineId=ID” where ID is the id of wrapper who has the HTML to show.
HTML content and Images support the following parameters:
modal
Setting modal=1 the lightbox will be close only clicking the button “close”, disabling the click event to overlay
background
Set the background color to the lightbox. Very useful when the HTML content loaded has a different background than white.
title
Show a legend below the content or image. Using this method it’s not possible insert html in the legend.
The SexyLightbox class is very flexible. Read the following documentation to view all available options.
Documentation
The following options are available for the class creation:
Background Styles
OverlayStyles
The css style is for the black background (it’s fade). You can change the color and the opacity.
LightBox Styles
Sexy Lightbox has two releases, the white and a black one. By default, it uses the black, but you can configure it to use it with white.
color
It admits: “black”, “white”, “blanco” or “negro”. By default it uses “black”. This option is used to locate images that will be used in the directory “sexyimages”.
emergefrom
It admits: “top” or “bottom”. By default it uses “top”. If you want the lightbox display “from bottom” use “bottom”.
find
Keyword used to search in the links where lightbox is going to be applied. By default is used “sexylightbox”. This option allows you to create different instances of lightbox and it can use each one in different links. Also, it allows the compatibility with the original lightbox, the keyword is “lightbox”.
Example Configuration
dir
Name of the directory that contains the images style. In this directory, you can found the colors directory (black and white). If you want to rename or relocate this directory in another folder, you should change this property.
Functions
You can access to the lightbox from javascript, thru the following functions:
close
Close the lightbox (if is open).
shake
refresh
display
display(url, title, force)
Opens the lightbox in the url sent. The “force” parameter (force=’image’), forces to show the lightbox as an image.
Known Issues
Animated gifs doesn’t work in Opera
It’s an Opera’s problem, that doesn’t fire the “onload” event when the gif is loaded. Nevertheles, once the gif is stored in cache, the event is fired correctly, so the image is shown with no problems. In other words, it doesnt have a solution.
The flash object is shown over the “overlay”
To solve this, you have to change the property wmode to transparent or opaque.
If you are using Adobe’s script, you should have something like:
If not, you are using the flash object as it is, you should have something like:
Notice that “wmode” is included in the embed and as “param”
Overlay opens but previous, next, and/or close links are missing
Make sure the files are actually on the server where you think they are, then double check the links in your header. Using absolute links (”http://…”) may help sort out buggy relative paths.
Make sure you’re not using Prototype.
Make sure the images are where you think they are.
License
The script is published under the MIT license.
Version
Sexy Lightbox 2.3.4
-
rightside:
-
footer: Sexy Lightbox 2.3.4 is made by Eduardo D. Sada and is released under the MIT license.
-