What is it?
Facebox is a jQuery-based, Facebook-style lightbox which can display images, divs, or entire remote pages.
It's simple to use and easy on the eyes. Download the tarball, view the examples, then start enjoying the curves.
Why another lightbox?
Because we wanted, nay, needed a Facebook-style lightbox on FamSpam.
Download
Requires jQuery 1.2.1.
You'll need a loading image, close label, four corners, and solid border images in addition to the javascript and css files. All are included in the tarball.
Want to live on the edge? The code is kept in GitHub at http://github.com/defunkt/facebox
Help!
Need help? Join our Google Groups mailing list.
Images
View '/facebox/stairs.jpg' in the Facebox
The Code
<a href="stairs.jpg" rel="facebox">text</a>
Load Dependencies
Make sure jQuery is loaded before Facebox.
<script src="jquery.js" type="text/javascript"></script>
<link href="/facebox/facebox.css" media="screen" rel="stylesheet" type="text/css"/>
<script src="/facebox/facebox.js" type="text/javascript"></script>
Attach It onLoad
While calling facebox() on any anchor tag will do the trick, it's easier to give your Faceboxy links a rel="facebox" and hit them all onLoad.
jQuery(document).ready(function($) {
$('a[rel*=facebox]').facebox()
})
Extra Classes
You can give the facebox container an extra class (to fine-tune the display of reusable remote pages)
with the facebox[.class] rel syntax.
Maybe your Terms and Conditions can be loaded standalone or via Facebox. When loaded in Facebox,
you might want to tweak some styles -- like making the h1 positioned absolutely?
We do this on FamSpam.
View an an example which makes the remote.html page bigger and bolder using css.
The Code
<a href="remote.html" rel="facebox[.bolder]">text</a>
Controlling Facebox Programmatically
It's possible to attain a higher level control over Facebox by calling methods directly. The following will open the Facebox and insert the passed string into it:
Arbitrary Text
jQuery.facebox('something cool')
If you plan to fill the Facebox with the result of an Ajax call, you'll want the loading graphic
displayed whilst your asynchronus task runs. This is the automatic behavior if the facebox()
method is passed a function.
Loading Image Displayed
jQuery.facebox(function() {
jQuery.get('code.js', function(data) {
jQuery.facebox('<textarea>' + data + '</textarea>')
})
})
Screenshots
See it in action on FamSpam!
You may also want to check out Stafftool, which uses Facebox.
Thanks & Contact
Thanks to Facebook for the idea and style. Thanks to Mindy Tchieu for her help in getting this working.
Comments, concerns, complaints, criticisms, confessions? Email me: chris@ozmm.org
