The Flowerpot is a jQuery plugin that allows you to overlay images, DOM elements, AJAX content, and iframes onto a web page. You can overlay a single item or associate multiple items (of any type) in a gallery.
Easy to use
class="flowerpot"to a link and let The Flowerpot's automatic link detection do the rest for you
Easy to customize
Built-in functions for changing locale strings (i18n) and settings, keeping you in control (including turning on/off automatic type detection and gallery thumbnails)
Automatically scales the overlay, regardless of the overlay type
Valid CSS and (X)HTML
Works in all major browsers
IE 6+, Firefox 2+, Safari 3+, Opera 9+, and Chrome 1+
The Flowerpot relies on the jQuery (1.3+) library (including jQuery 1.4). You'll need to load the included CSS as well.
Any element on the page with the class "flowerpot" will launch an overlay. To get a linked image to appear in an overlay, it's as easy as
<a href="photo.jpg" class="flowerpot">Image</a>. And with automatic type detection, you can link to images, inline divs, YouTube/Vimeo videos, pages on your domain (for AJAX), or external sites (for iFrames).
<a href="photo.jpg" class="flowerpot">Image</a>
Opens "photo.jpg" in an overlay. The image will be scaled down if it exceeds the size of the browser window.
<a href="#video" class="flowerpot" rel="div">Watch Video</a>
Displays the element with the ID "video" in the overlay.
<a href="ajax.html" class="flowerpot" rel="div">Load Content</a>
Displays the text/HTML returned by "ajax.html" in the overlay.
<a href="http://apple.ca" class="flowerpot" rel="iframe">Apple Canada</a>
Display the URL inside the
href attribute in the overlay, using an inline frame. With automatic type detection on, The Flowerpot loads external URLs (ones not matching the hostname from location.href) in an iFrame.
<a href="http://www.youtube.com/watch?v=ILo1v6Y7IB4" class="flowerpot" rel="youtube">YouTube Music Video</a>
Display the YouTube video at the link specified.
Multiple items can be viewed one after another without closing the overlay by adding
rel="gallery[NAME]" to each element that should be part of that gallery. You can have as many galleries as you like, with as many items as you'd like, and you can mix all kinds of content in a gallery (i.e. images and iFrames in the same gallery).
In keeping with jQuery and most of its plugins, The Flowerpot is dual-licensed under the MIT and GPL (v2 or later) licenses. This means you can pick whichever license you want to use for your project.