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.
Load Dependencies
Make sure jQuery is loaded before Facebox.
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.The Code
text
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');
jQuery.facebox('something cool', 'my-groovy-style');
Remote files
jQuery.facebox({ ajax: 'remote.html' });
jQuery.facebox({ ajax: 'remote.html' }, 'my-groovy-style');
Image
jQuery.facebox({ image: 'stairs.jpg' });
jQuery.facebox({ image: 'stairs.jpg' }, 'my-groovy-style');
A Page Element
jQuery.facebox({ div: '#box' });
jQuery.facebox({ div: '#box' }, 'my-groovy-style');
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('')
})
})
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
0 Comments