/* This notice must be untouched at all times.
wz_tooltip.js v. 4.0
The latest version is available at
http://www.walterzorn.com
or http://www.devira.com
or http://www.walterzorn.de
Copyright (c) 2002-2007 Walter Zorn. All rights reserved.
Created 1.12.2002 by Walter Zorn (Web: http://www.walterzorn.com )
Last modified: 28.5.2007
Easy-to-use cross-browser tooltips.
Just include the script at the beginning of the section, and invoke
Tip('Tooltip text') from within the desired HTML onmouseover eventhandlers.
No container DIV, no onmouseouts required.
By default, width of tooltips is automatically adapted to content.
Is even capable of dynamically converting arbitrary HTML elements to tooltips
by calling TagToTip('ID_of_HTML_element_to_be_converted') instead of Tip(),
which means you can put important, search-engine-relevant stuff into tooltips.
Appearance of tooltips can be individually configured
via commands passed to Tip() or TagToTip().
Tab Width: 4
LICENSE: LGPL
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License (LGPL) as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
For more details on the GNU Lesser General Public License,
see http://www.gnu.org/copyleft/lesser.html
*/
var config = new Object();
//=================== GLOBAL TOOPTIP CONFIGURATION =========================//
var Debug = true // false or true - recommended: false once you release your page to the public
var TagsToTip = true // false or true - if true, the script is capable of converting HTML elements to tooltips
// For each of the following config variables there exists a command, which is
// just the variablename in uppercase, to be passed to Tip() or TagToTip() to
// configure tooltips individually. Individual commands override global
// configuration. Order of commands is arbitrary.
// Example: onmouseover="Tip('Tooltip text', LEFT, true, BGCOLOR, '#FF9900', FADEOUT, 400)"
config. Above = false // false or true - tooltip above mousepointer?
config. BgColor = '' // Background color
config. BgImg = '' // Path to background image, none if empty string ''
config. BorderColor = '#002299'
config. BorderStyle = 'solid' // Any permitted CSS value, but I recommend 'solid', 'dotted' or 'dashed'
config. BorderWidth = 0
config. CenterMouse = true // false or true - center the tip horizontally below (or above) the mousepointer
config. ClickClose = false // false or true - close tooltip if the user clicks somewhere
config. CloseBtn = false // false or true - closebutton in titlebar
config. CloseBtnColors = ['#990000', '#FFFFFF', '#DD3333', '#FFFFFF'] // [Background, text, hovered background, hovered text] - use empty strings '' to inherit title colors
config. CloseBtnText = 'Close' // Close button text (may also be an image tag)
config. Delay = 50 // Time span in ms until tooltip shows up
config. Duration = 0 // Time span in ms after which the tooltip disappears; 0 for infinite duration
config. FadeIn = 0 // Fade-in duration in ms, e.g. 400; 0 for no animation
config. FadeOut = 0
config. FadeInterval = 5 // Duration of each fade step in ms (recommended: 30) - shorter is smoother but causes more CPU-load
config. Fix = null // Fixated position - x- an y-oordinates in brackets, e.g. [200, 200], or null for no fixation
config. FollowMouse = false // false or true - tooltip follows the mouse
config. FontColor = '#000044'
config. FontFace = 'Verdana,Geneva,sans-serif'
config. FontSize = '8pt' // E.g. '9pt' or '12px' - specifying the unit is mandatory
config. FontWeight = 'normal' // 'normal' or 'bold';
config. Left = false // false or true - tooltip on the left of the mouse
config. OffsetX = 14 // Horizontal offset of left-top corner from mousepointer
config. OffsetY = 0 // Vertical offset
config. Opacity = 100 // Integer between 0 and 100 - opacity of tooltip in percent
config. Padding = 3 // Spacing between border and content
config. Shadow = false // false or true
config. ShadowColor = '#C0C0C0'
config. ShadowWidth = 5
config. Sticky = false // Do NOT hide tooltip on mouseout? false or true
config. TextAlign = 'right' // 'left', 'right' or 'justify'
config. Title = '' // Default title text applied to all tips (no default title: empty string '')
config. TitleAlign = 'left' // 'left' or 'right' - text alignment inside the title bar
config. TitleBgColor = '' // If empty string '', BorderColor will be used
config. TitleFontColor = '' // Color of title text - if '', BgColor will be used
config. TitleFontFace = '' // If '' use FontFace (boldified)
config. TitleFontSize = '' // If '' use FontSize
config. Width = '50' // Tooltip width; 0 for automatic adaption to tooltip content
//====================== END OF TOOLTIP CONFIG =============================//
//====================== PUBLIC ============================================//
function Tip()
{
tt_Tip(arguments);
}
function TagToTip()
{
var t_a = arguments, t_el;
if(TagsToTip)
{
t_el = tt_GetElt(t_a[0]);
if(t_el)
{
t_a[0] = t_el.innerHTML;
tt_Tip(t_a);
}
}
}
//================== PUBLIC EXTENSION API ==================================//
// Specifiers for extension callback functions
var
ONCONFIG = 0,
ONMOUSEMOVE = 1,
ONHIDEINIT = 2,
ONHIDE = 3,
tt_aElt = new Array(10), // Container DIV, outer title and body DIVs, inner TITLE and body SPAN, closebutton SPAN in title, shadow DIVs, and IFRAME to cover windowed elements in IE
tt_aV = new Array(), // Caches and enumerates config data for currently active tooltip
tt_w, tt_h; // Width and height of currently displayed tooltip
// Registers callback functions, to be invoked upon certain occasions. Example:
// tt_AddExtension(ONMOUSEMOVE, PointerToMoveFunction, ONCONFIG, PointerToConfigFunction, ...);
function tt_AddExtension()
{
return (new tt_Extension(arguments) != null);
}
function tt_SetTipPos(t_x, t_y)
{
var t_css = tt_aElt[0].style;
t_css.left = t_x + "px";
t_css.top = t_y + "px";
if(tt_ie56)
{
var t_ifrm = tt_aElt[tt_aElt.length - 1];
if(t_ifrm)
{
t_ifrm.style.left = t_css.left;
t_ifrm.style.top = t_css.top;
}
}
}
function tt_HideTip()
{
if(tt_db)
{
tt_ExtCallFunc(0, ONHIDE);
tt_tShow.EndTimer();
tt_tHide.EndTimer();
tt_tDurt.EndTimer();
tt_tFade.EndTimer();
if(!tt_op && !tt_ie)
{
tt_tWaitMov.EndTimer();
tt_bWait = false;
}
if(tt_aV[CLICKCLOSE])
tt_RemEvtFnc(document, "mouseup", tt_HideInit);
tt_AddRemEvtFncEx(1, false);
tt_AddRemEvtFncEx(0, false);
tt_b = false;
tt_over = null;
tt_ResetMainDiv();
if(tt_aElt[tt_aElt.length - 1])
tt_aElt[tt_aElt.length - 1].style.display = "none";
}
}
function tt_GetDivW(t_el)
{
if(t_el)
return(t_el.offsetWidth || t_el.style.pixelWidth || 0);
return 0;
}
function tt_GetDivH(t_el)
{
if(t_el)
return(t_el.offsetHeight || t_el.style.pixelHeight || 0);
return 0;
}
function tt_GetScrollX()
{
return((typeof(window.pageXOffset) != tt_u) ? window.pageXOffset
: tt_db ? (tt_db.scrollLeft || 0)
: 0);
}
function tt_GetScrollY()
{
return((typeof(window.pageYOffset) != tt_u) ? window.pageYOffset
: tt_db ? (tt_db.scrollTop || 0)
: 0);
}
function tt_GetClientW()
{
return(document.body && (typeof(document.body.clientWidth) != tt_u) ? document.body.clientWidth
: (typeof(window.innerWidth) != tt_u) ? window.innerWidth
: tt_db ? (tt_db.clientWidth || 0)
: 0);
}
function tt_GetClientH()
{
// Exactly this order seems to yield correct values in all major browsers
return(document.body && (typeof(document.body.clientHeight) != tt_u) ? document.body.clientHeight
: (typeof(window.innerHeight) != tt_u) ? window.innerHeight
: tt_db ? (tt_db.clientHeight || 0)
: 0);
}
function tt_AddEvtFnc(t_el, t_sEvt, t_PFnc)
{
if(t_el)
{
if(t_el.addEventListener)
t_el.addEventListener(t_sEvt, t_PFnc, false);
else
t_el.attachEvent("on" + t_sEvt, t_PFnc);
}
}
function tt_RemEvtFnc(t_el, t_sEvt, t_PFnc)
{
if(t_el)
{
if(t_el.removeEventListener)
t_el.removeEventListener(t_sEvt, t_PFnc, false);
else
t_el.detachEvent("on" + t_sEvt, t_PFnc);
}
}
//====================== PRIVATE ===========================================//
var tt_aExt = new Array(), // Array of extension objects
tt_db, tt_op, tt_op78, tt_ie, tt_ie56, tt_bBoxOld, // Browser flags
tt_body,
tt_flagOpa, // Opacity support: 1=IE, 2=Khtml, 3=KHTML, 4=Moz, 5=W3C
tt_scrlX, tt_scrlY,
tt_maxPosX, tt_maxPosY,
tt_b, // Tooltip active
tt_over, // Hovered HTML element
tt_opa, // Currently applied opacity
tt_bJmpVert, // tip above mouse (or ABOVE tip below mouse)
tt_elDeHref, // The tag from which Opera has removed the href attribute
// Timer
tt_tShow = new Number(0), tt_tHide = new Number(0), tt_tDurt = new Number(0),
tt_tFade = new Number(0), tt_tWaitMov = new Number(0),
tt_bMovFnc, tt_bOutFnc,
tt_bWait = false,
tt_u = "undefined";
function tt_Init()
{
tt_MkCmdEnum();
// Send old browsers instantly to hell
if(!tt_Browser() || !tt_MkMainDiv())
return;
tt_IsW3cBoxing();
tt_OpaSupport();
// In Debug mode we search for TagToTip() calls in order to notify
// the user if they've forgotten to set the TagsToTip config flag
if(TagsToTip || Debug)
tt_SetOnloadFnc();
tt_AddEvtFnc(window, "scroll", tt_HideOnScrl);
// Ensure the tip be hidden when the page unloads
tt_AddEvtFnc(window, "unload", tt_HideTip);
tt_HideTip();
}
// Creates command names by translating config variable names to upper case
function tt_MkCmdEnum()
{
var t_n = 0;
for(var i in config)
eval("window." + i.toString().toUpperCase() + " = " + t_n++);
tt_aV.length = t_n;
}
function tt_Browser()
{
var t_n, t_nv, t_n6, t_w3c;
t_n = navigator.userAgent.toLowerCase(),
t_nv = navigator.appVersion;
tt_op = (document.defaultView && typeof(eval("w" + "indow" + "." + "o" + "p" + "er" + "a")) != tt_u);
tt_op78 = (tt_op && !window.getSelection);
tt_ie = t_n.indexOf("msie") != -1 && document.all && !tt_op;
if(tt_ie)
{
var t_ieOld = (!document.compatMode || document.compatMode == "BackCompat");
tt_db = !t_ieOld ? document.documentElement : (document.body || null);
if(tt_db)
tt_ie56 = parseFloat(t_nv.substring(t_nv.indexOf("MSIE") + 5)) >= 5.5
&& typeof document.body.style.maxHeight == tt_u;
}
else
{
tt_db = document.documentElement || document.body ||
(document.getElementsByTagName ? document.getElementsByTagName("body")[0]
: null);
if(!tt_op)
{
t_n6 = document.defaultView && typeof document.defaultView.getComputedStyle != tt_u;
t_w3c = !t_n6 && document.getElementById;
}
}
tt_body = (document.getElementsByTagName ? document.getElementsByTagName("body")[0]
: (document.body || null));
if(tt_ie || t_n6 || tt_op || t_w3c)
{
if(tt_body && tt_db)
{
if(document.attachEvent || document.addEventListener)
return true;
}
else
tt_Err("wz_tooltip.js must be included INSIDE the body section,"
+ " immediately after the opening tag.");
}
tt_db = null;
return false;
}
function tt_MkMainDiv()
{
// Create the tooltip DIV
if(tt_body.insertAdjacentHTML)
tt_body.insertAdjacentHTML("afterBegin", tt_MkMainDivHtm());
else if(typeof tt_body.innerHTML != tt_u && document.createElement && tt_body.appendChild)
tt_body.appendChild(tt_MkMainDivDom());
// FireFox Alzheimer bug
if(window.tt_GetMainDivRefs && tt_GetMainDivRefs())
return true;
tt_db = null;
return false;
}
function tt_MkMainDivHtm()
{
return('' +
(tt_ie56 ? ('')
: ''));
}
function tt_MkMainDivDom()
{
var t_el;
t_el = document.createElement("div");
if(t_el)
{
var t_css = t_el.style;
t_el.id = "WzTtDiV";
t_css.position = "absolute";
t_css.overflow = "hidden";
}
return t_el;
}
function tt_GetMainDivRefs()
{
tt_aElt[0] = tt_GetElt("WzTtDiV");
if(tt_ie56 && tt_aElt[0])
{
tt_aElt[tt_aElt.length - 1] = tt_GetElt("WzTtIfRm");
if(!tt_aElt[tt_aElt.length - 1])
tt_aElt[0] = null;
}
return(tt_aElt[0] != null);
}
function tt_ResetMainDiv()
{
var t_css = tt_aElt[0].style;
t_css.visibility = "hidden";
t_css.left = "-9999px";
tt_aElt[0].innerHTML = "";
t_css.width = "9998px";
}
function tt_IsW3cBoxing()
{
var t_css = tt_aElt[0].style;
t_css.padding = "10px";
t_css.width = "40px";
tt_bBoxOld = (tt_GetDivW(tt_aElt[0]) == 40);
t_css.padding = "0px";
tt_ResetMainDiv();
}
function tt_OpaSupport()
{
var t_css = tt_body.style;
tt_flagOpa = (typeof(t_css.filter) != tt_u) ? 1
: (typeof(t_css.KhtmlOpacity) != tt_u) ? 2
: (typeof(t_css.KHTMLOpacity) != tt_u) ? 3
: (typeof(t_css.MozOpacity) != tt_u) ? 4
: (typeof(t_css.opacity) != tt_u) ? 5
: 0;
}
// Ported from http://dean.edwards.name/weblog/2006/06/again/ (Dean Edwards)
function tt_SetOnloadFnc()
{
tt_AddEvtFnc(document, "DOMContentLoaded", tt_HideSrcTags);
tt_AddEvtFnc(window, "load", tt_HideSrcTags);
// Conditional comment below is IE code - DON'T REMOVE!!!
/*@cc_on
if(document.attachEvent)
document.attachEvent("onreadystatechange",
function(){ if(document.readyState == "complete") tt_HideSrcTags(); });
document.write('<\/scr' + 'ipt>');
var script = document.getElementById("TT_ie_onload");
script.onreadystatechange = function() {
if(this.readyState == "complete")
tt_HideSrcTags();
};
@*/
if(/WebKit|KHTML/i.test(navigator.userAgent))
{
var t_t = setInterval(function() {
if(/loaded|complete/.test(document.readyState))
{
clearInterval(t_t);
tt_HideSrcTags();
}
}, 10);
}
}
function tt_HideSrcTags()
{
if(!window.tt_HideSrcTags || window.tt_HideSrcTags.t_done)
return;
window.tt_HideSrcTags.t_done = true;
if(!tt_HideSrcTagsRecurs(tt_body))
tt_Err("To enable the capability to convert HTML elements to tooltips,"
+ " you must set TagsToTip in the global tooltip configuration"
+ " to true.");
}
function tt_HideSrcTagsRecurs(t_dad)
{
var t_a, t_ovr, t_asT2t;
// Walk the DOM tree for tags that have an onmouseover attribute
// containing a TagToTip('...') call
t_a = t_dad.children || t_dad.childNodes || null;
for(var i = t_a ? t_a.length : 0; i;)
{--i;
if(!tt_HideSrcTagsRecurs(t_a[i]))
return false;
t_ovr = t_a[i].getAttribute ? t_a[i].getAttribute("onmouseover")
: (typeof t_a[i].onmouseover == "function") ? t_a[i].onmouseover
: null;
if(t_ovr)
{
t_asT2t = t_ovr.toString().match(/TagToTip\s*\(\s*'[^'.]+'\s*[\),]/);
if(t_asT2t && t_asT2t.length)
{
if(!tt_HideSrcTag(t_asT2t[0]))
return false;
}
}
}
return true;
}
function tt_HideSrcTag(t_sT2t)
{
var t_id, t_el;
// The ID passed to the found TagToTip() call identifies an HTML element
// to be converted to a tooltip, so hide that element
t_id = t_sT2t.replace(/.+'([^'.]+)'.+/, "$1");
t_el = tt_GetElt(t_id);
if(t_el)
{
if(Debug && !TagsToTip)
return false;
else
t_el.style.display = "none";
}
else
tt_Err("Invalid ID\n'" + t_id + "'\npassed to TagToTip()."
+ " There exists no HTML element with that ID.");
return true;
}
function tt_Tip(t_arg)
{
if(!tt_db)
return;
if(tt_over)
tt_HideTip();
if(!tt_ReadCmds(t_arg))
return;
tt_b = true;
tt_AdaptConfig1();
tt_MkTipSubDivs(t_arg[0]);
tt_FormatTip();
tt_AddRemEvtFncEx(0, true);
tt_bJmpVert = false;
tt_scrlX = tt_GetScrollX();
tt_scrlY = tt_GetScrollY();
tt_maxPosX = tt_GetClientW() + tt_scrlX - tt_w - 1;
tt_maxPosY = tt_GetClientH() + tt_scrlY - tt_h - 1;
tt_AdaptConfig2();
// IE and Op won't fire a mousemove accompanying the mouseover, so we
// must ourselves fake that first mousemove in order to ensure the tip
// be immediately shown and positioned
if(window.event)
tt_Move(window.event);
}
function tt_ReadCmds(t_a)
{
var i;
// First load the global config values, to initialize also values
// for which no command has been passed
i = 0;
for(var j in config)
tt_aV[i++] = config[j];
// Then replace each cached config value for which a command has been
// passed; ensure the # of command args plus value args be even
if(t_a.length & 1)
{
for(i = t_a.length - 1; i > 0; i -= 2)
tt_aV[t_a[i - 1]] = t_a[i];
return true;
}
tt_Err("Incorrect call of Tip() or TagToTip().\n"
+ "Each command must be followed by a value.");
return false;
}
function tt_AdaptConfig1()
{
tt_ExtCallFunc(0, ONCONFIG);
// Inherit unspecified title formattings from body
if(!tt_aV[TITLEBGCOLOR].length)
tt_aV[TITLEBGCOLOR] = tt_aV[BORDERCOLOR];
if(!tt_aV[TITLEFONTCOLOR].length)
tt_aV[TITLEFONTCOLOR] = tt_aV[BGCOLOR];
if(!tt_aV[TITLEFONTFACE].length)
tt_aV[TITLEFONTFACE] = tt_aV[FONTFACE];
if(!tt_aV[TITLEFONTSIZE].length)
tt_aV[TITLEFONTSIZE] = tt_aV[FONTSIZE];
if(tt_aV[CLOSEBTN])
{
// Use title colors for non-specified closebutton colors
if(!tt_aV[CLOSEBTNCOLORS])
tt_aV[CLOSEBTNCOLORS] = new Array("", "", "", "");
for(var i = 4; i;)
{--i;
if(!tt_aV[CLOSEBTNCOLORS][i].length)
tt_aV[CLOSEBTNCOLORS][i] = (i & 1) ? tt_aV[TITLEFONTCOLOR] : tt_aV[TITLEBGCOLOR];
}
// Enforce titlebar be shown
if(!tt_aV[TITLE].length)
tt_aV[TITLE] = " ";
}
// Circumvents broken display of images and fade-in flicker in old Geckos.
// TODO: Execute only in Geckos old enough to suffer from these bugs
if(tt_aV[OPACITY] == 100 && typeof tt_aElt[0].style.MozOpacity != tt_u)
tt_aV[OPACITY] = 99;
// Smartly shorten the delay for fade-in tooltips
if(tt_aV[FADEIN] && tt_flagOpa && tt_aV[DELAY] > 100)
tt_aV[DELAY] = Math.max(tt_aV[DELAY] - tt_aV[FADEIN], 100)
}
function tt_AdaptConfig2()
{
if(tt_aV[CENTERMOUSE])
tt_aV[OFFSETX] = -((tt_w - (tt_aV[SHADOW] ? tt_aV[SHADOWWIDTH] : 0)) >> 1);
}
function tt_MkTipSubDivs(t_htm)
{
var t_sTbTr = ' cellpadding="0" cellspacing="0" border="0" style="position:relative;margin:0px;border-width:0px;">