/**
 * This file contains useful generic methods that may be 
 * used throughout the site.
 */

/* jquery utilities */

/**
 * setupHoverToggleClass - jquery function that toggles between the css
 * classes passed as parameters on hover: mouseOutClass will be applied
 * on mouseout, and mouseOverClass will be applied on mouseover.
 * If the unbind parameter is true, all previous hover handlers are
 * removed from selector.
 */ 
function setupHoverToggleClass(selector, mouseOutClass, mouseOverClass, unbind)
{
    if(unbind == true)
    {
        $(selector).unbind("hover");
    }
    $(selector).hover(
        function()
        {
            $(this).removeClass(mouseOutClass);
            $(this).addClass(mouseOverClass);
        },
        function()
        {
            $(this).removeClass(mouseOverClass);
            $(this).addClass(mouseOutClass);
        }
    );
}