/**
* LavaLamp - A menu plugin for jQuery with cool hover effects.
* @requires jQuery v1.2.x or higher
*
* http://nixbox.com/lavalamp.php
*
* Copyright (c) 2008, 2009 Jolyon Terwilliger, jolyon@nixbox.com
* Original code Copyright (c) 2007, 2008
* Dual licensed under the MIT and GPL licenses:
* http://www.opensource.org/licenses/mit-license.php
* http://www.gnu.org/licenses/gpl.html
*
* credits to Guillermo Rauch and Ganeshji Marwaha (gmarwaha.com) for previous editions
*
* Version: 1.0 - adapted for jQuery 1.2.x series
* Version: 1.1 - added linum parameter
* Version: 1.2 - modified to support vertical resizing of elements
* Version: 1.3 - enhanced automatic item hi-lighting - will attempt to
* lock onto li > a element with href closest to selected
* window.location
* - click always returns 'true' by default, for standard link follow through.
*
* Version: 1.3.1 - verified for use with jQuery 1.3 - should still work with 1.2.x series
* - changed linum parameter to startItem for clarity
* - improved slide-in accuracy for .back elements with borders
* - changed .current class to .selectedLava for clarity and improved
* support
* - appended 'Lava' to all internal class names to avoid conflicts
* - fixed bug applying selectedLava class to elements with matching
* location.hash
* - now supports jquery.compat plugin for cross-library support
* - performance improvements
* - added new options:
* autoReturn: true - if set to false, hover will not return to last selected
* item upon list mouseout.
* returnDelay: 0 - if set, will delay auto-return feature specified # of
* milliseconds.
* setOnClick: true - if set to false, hover will return to default element
* regardless of click event.
* homeLeft: 0, homeTop: 0 - if either set to non zero value, absolute
* positioned li element with class .homeLava is
* prepended to list for homing feature.
* homeWidth: 0, homeHeight: 0 - if set, are used for creation of li.homeLava
* element.
* returnHome: false - if set along with homeLeft or homeTop, lavalamp hover
* will always return to li.home after click.
*
* Version: 1.3.2 - fixed stray $ references inside the plugin to work with
* jQuery.noConflict() properly - thanks Colin.
*
* Creates a menu with an unordered list of menu-items. You can either use the CSS
* that comes with the plugin, or write your own styles
*
* The HTML markup used to build the menu can be as simple as...
*
*
*
* Once you have included the style sheet that comes with the plugin, you will have to include
* a reference to the jQuery library, easing plugin (optional) and the LavaLamp(this) plugin.
*
* Use the following snippet to initialize the menu using jQuery easing library::
* Easing Library 1.3 available here: http://plugins.jquery.com/project/Easing
*
* $(function() { $(".lavaLamp").lavaLamp({ fx: "easeOutBack", speed: 700}) });
*
* @param Object - You can specify all the options shown below as object variables:
*
* @option fx - default is "swing"
* @example
* $(".lavaLamp").lavaLamp({ fx: "easeOutElastic" });
* @desc Creates a menu with "Elastic" easing effect. You need to include the easing plugin for this to work.
*
* @option speed - default is 500 ms
* @example
* $(".lavaLamp").lavaLamp({ speed: 500 });
* @desc Creates a menu with an animation speed of 500 ms.
*
* @option click - no defaults
* @example
* $(".lavaLamp").lavaLamp({ click: function(event, menuItem) { return false; } });
* @desc You can supply a callback to be executed when the menu item is clicked.
* The event object and the menu-item that was clicked will be passed in as arguments.
*
* @option startItem - default is 'no'
* @example
* jQuery(".lavaLamp").lavaLamp({ startItem: 2 });
* @desc startItem specifies the li element to default to, beginning with 0 for the first li element
* within the parent UL or OL used to initialize lavaLamp. This can be used to set default
* lavaLamp hilight on page reloads.
*/
(function(jQuery) {
jQuery.fn.lavaLamp = function(o) {
o = jQuery.extend({
fx: 'swing',
speed: 500,
click: function(){
return true
},
startItem: 'no',
autoReturn: true,
returnDelay: 0,
setOnClick: true,
homeTop:0,
homeLeft:0,
homeWidth:0,
homeHeight:0,
returnHome:false
},
o || {});
return this.each(function() {
var path = location.pathname + location.search + location.hash;
var $selected = new Object;
var delayTimer;
var $back;
var $home;
var ce;
//
// create homeLava element if origin and dimensions set and startItem == off
if (o.homeTop || o.homeLeft) {
$home = jQuery('').css({
left:o.homeLeft,
top:o.homeTop,
width:o.homeWidth,
height:o.homeHeight,
position:'absolute'
});
jQuery(this).prepend($home);
}
var $li = jQuery('li', this);
// check for complete path match, if so flag element into $selected
if ( o.startItem == 'no' )
$selected = jQuery('li a[href$="' + path + '"]', this).parent('li');
// double check, this may be just an anchor match
if ($selected.length == 0 && o.startItem == 'no' && location.hash)
$selected = jQuery('li a[href$="' + location.hash + '"]', this).parent('li');
// no default selected element matches worked,
// or the user specified an index via startItem
if ($selected.length == 0 || o.startItem != 'no') {
// always default to first item, if no startItem specified.
if (o.startItem == 'no') o.startItem = 0;
$selected = jQuery($li[o.startItem]);
}
// set up raw element - this allows user override by class .selectedLava on load
ce = jQuery('li.selectedLava', this)[0] || jQuery($selected).addClass('selectedLava')[0];
// add mouseover event for every sub element
$li.mouseover(function() {
if (jQuery(this).hasClass('homeLava')) {
ce = jQuery(this)[0];
}
move(this);
});
$back = jQuery('').appendTo(this);
// Add event to handle window resizing
$(window).resize(function() {
moveWithoutAnimate(null);
});
// after we leave the container element, move back to default/last clicked element
jQuery(this).mouseout( function() {
if (o.autoReturn) {
if (o.returnHome && $home) {
move($home[0]);
}
else if (o.returnDelay) {
if(delayTimer) clearTimeout(delayTimer);
delayTimer = setTimeout(move,o.returnDelay + o.speed);
}
else {
move();
}
}
});
$li.click(function(e) {
if (o.setOnClick) {
jQuery(ce).removeClass('selectedLava');
jQuery(this).addClass('selectedLava');
ce = this;
}
return o.click.apply(this, [e, this]);
});
// set the starting position for the lavalamp hover element: .back
if (o.homeTop || o.homeLeft)
$back.css({
left:o.homeLeft,
top:o.homeTop,
width:o.homeWidth,
height:o.homeHeight
});
else
$back.css({
left: ce.offsetLeft,
top: ce.offsetTop,
width: ce.offsetWidth,
height: ce.offsetHeight
});
function move(el) {
if (!el) el = ce;
// .backLava element border check and animation fix
var bx=0, by=0;
if (!jQuery.browser.msie) {
bx = ($back.outerWidth() - $back.innerWidth())/2;
by = ($back.outerHeight() - $back.innerHeight())/2;
}
$back.stop()
.animate({
left: el.offsetLeft-bx,
top: el.offsetTop-by,
width: el.offsetWidth,
height: el.offsetHeight
}, o.speed, o.fx);
};
function moveWithoutAnimate(el) {
if (!el) el = ce;
// .backLava element border check and animation fix
var bx=0, by=0;
if (!jQuery.browser.msie) {
bx = ($back.outerWidth() - $back.innerWidth())/2;
by = ($back.outerHeight() - $back.innerHeight())/2;
}
$back.stop()
.css({
left: el.offsetLeft-bx,
top: el.offsetTop-by,
width: el.offsetWidth,
height: el.offsetHeight
});
};
});
};
})(jQuery);