/*! * qTip2 - Pretty powerful tooltips * http://craigsworks.com/projects/qtip2/ * * Version: nightly * Copyright 2009-2010 Craig Michael Thompson - http://craigsworks.com * * Dual licensed under MIT or GPLv2 licenses * http://en.wikipedia.org/wiki/MIT_License * http://en.wikipedia.org/wiki/GNU_General_Public_License * * Date: Sun Jul 15 16:44:57.0000000000 2012 */ /*jslint browser: true, onevar: true, undef: true, nomen: true, bitwise: true, regexp: true, newcap: true, immed: true, strict: true */ /*global window: false, jQuery: false, console: false, define: false */ // Uses AMD or browser globals to create a jQuery plugin. (function(factory) { if(typeof define === 'function' && define.amd) { define(['jquery'], factory); } else if(jQuery && !jQuery.fn.qtip) { factory(jQuery); } } (function($) { "use strict"; // Enable ECMAScript "strict" operation for this function. See more: http://ejohn.org/blog/ecmascript-5-strict-mode-json-and-more/ // Munge the primitives - Paul Irish tip var TRUE = true, FALSE = false, NULL = null, undefined, // Side names and other stuff X = 'x', Y = 'y', WIDTH = 'width', HEIGHT = 'height', TOP = 'top', LEFT = 'left', BOTTOM = 'bottom', RIGHT = 'right', CENTER = 'center', FLIP = 'flip', FLIPINVERT = 'flipinvert', SHIFT = 'shift', // Shortcut vars QTIP, PLUGINS, MOUSE, usedIDs = {}, uitooltip = 'ui-tooltip', widget = 'ui-widget', disabled = 'ui-state-disabled', selector = 'div.qtip.'+uitooltip, defaultClass = uitooltip + '-default', focusClass = uitooltip + '-focus', hoverClass = uitooltip + '-hover', fluidClass = uitooltip + '-fluid', hideOffset = '-31000px', replaceSuffix = '_replacedByqTip', oldtitle = 'oldtitle', trackingBound; /* Thanks to Paul Irish for this one: http://paulirish.com/2009/log-a-lightweight-wrapper-for-consolelog/ */ function log() { log.history = log.history || []; log.history.push(arguments); // Make sure console is present if('object' === typeof console) { // Setup console and arguments var c = console[ console.warn ? 'warn' : 'log' ], args = Array.prototype.slice.call(arguments), a; // Add qTip2 marker to first argument if it's a string if(typeof arguments[0] === 'string') { args[0] = 'qTip2: ' + args[0]; } // Apply console.warn or .log if not supported a = c.apply ? c.apply(console, args) : c(args); } } // Option object sanitizer function sanitizeOptions(opts) { var content; if(!opts || 'object' !== typeof opts) { return FALSE; } if(opts.metadata === NULL || 'object' !== typeof opts.metadata) { opts.metadata = { type: opts.metadata }; } if('content' in opts) { if(opts.content === NULL || 'object' !== typeof opts.content || opts.content.jquery) { opts.content = { text: opts.content }; } content = opts.content.text || FALSE; if(!$.isFunction(content) && ((!content && !content.attr) || content.length < 1 || ('object' === typeof content && !content.jquery))) { opts.content.text = FALSE; } if('title' in opts.content) { if(opts.content.title === NULL || 'object' !== typeof opts.content.title) { opts.content.title = { text: opts.content.title }; } content = opts.content.title.text || FALSE; if(!$.isFunction(content) && ((!content && !content.attr) || content.length < 1 || ('object' === typeof content && !content.jquery))) { opts.content.title.text = FALSE; } } } if('position' in opts) { if(opts.position === NULL || 'object' !== typeof opts.position) { opts.position = { my: opts.position, at: opts.position }; } } if('show' in opts) { if(opts.show === NULL || 'object' !== typeof opts.show) { if(opts.show.jquery) { opts.show = { target: opts.show }; } else { opts.show = { event: opts.show }; } } } if('hide' in opts) { if(opts.hide === NULL || 'object' !== typeof opts.hide) { if(opts.hide.jquery) { opts.hide = { target: opts.hide }; } else { opts.hide = { event: opts.hide }; } } } if('style' in opts) { if(opts.style === NULL || 'object' !== typeof opts.style) { opts.style = { classes: opts.style }; } } // Sanitize plugin options $.each(PLUGINS, function() { if(this.sanitize) { this.sanitize(opts); } }); return opts; } /* * Core plugin implementation */ function QTip(target, options, id, attr) { // Declare this reference var self = this, docBody = document.body, tooltipID = uitooltip + '-' + id, isPositioning = 0, isDrawing = 0, tooltip = $(), namespace = '.qtip-' + id, elements, cache; // Setup class attributes self.id = id; self.rendered = FALSE; self.destroyed = FALSE; self.elements = elements = { target: target }; self.timers = { img: {} }; self.options = options; self.checks = {}; self.plugins = {}; self.cache = cache = { event: {}, target: $(), disabled: FALSE, attr: attr, onTarget: FALSE, lastClass: '' }; /* * Private core functions */ function convertNotation(notation) { var i = 0, obj, option = options, // Split notation into array levels = notation.split('.'); // Loop through while( option = option[ levels[i++] ] ) { if(i < levels.length) { obj = option; } } return [obj || options, levels.pop()]; } function setWidget() { var on = options.style.widget; tooltip.toggleClass(widget, on).toggleClass(defaultClass, options.style.def && !on); elements.content.toggleClass(widget+'-content', on); if(elements.titlebar){ elements.titlebar.toggleClass(widget+'-header', on); } if(elements.button){ elements.button.toggleClass(uitooltip+'-icon', !on); } } function removeTitle(reposition) { if(elements.title) { elements.titlebar.remove(); elements.titlebar = elements.title = elements.button = NULL; // Reposition if enabled if(reposition !== FALSE) { self.reposition(); } } } function createButton() { var button = options.content.title.button, isString = typeof button === 'string', close = isString ? button : 'Close tooltip'; if(elements.button) { elements.button.remove(); } // Use custom button if one was supplied by user, else use default if(button.jquery) { elements.button = button; } else { elements.button = $('', { 'class': 'ui-state-default ui-tooltip-close ' + (options.style.widget ? '' : uitooltip+'-icon'), 'title': close, 'aria-label': close }) .prepend( $('', { 'class': 'ui-icon ui-icon-close', 'html': '×' }) ); } // Create button and setup attributes elements.button.appendTo(elements.titlebar) .attr('role', 'button') .click(function(event) { if(!tooltip.hasClass(disabled)) { self.hide(event); } return FALSE; }); // Redraw the tooltip when we're done self.redraw(); } function createTitle() { var id = tooltipID+'-title'; // Destroy previous title element, if present if(elements.titlebar) { removeTitle(); } // Create title bar and title elements elements.titlebar = $('
', { 'class': uitooltip + '-titlebar ' + (options.style.widget ? 'ui-widget-header' : '') }) .append( elements.title = $('
', { 'id': id, 'class': uitooltip + '-title', 'aria-atomic': TRUE }) ) .insertBefore(elements.content) // Button-specific events .delegate('.ui-tooltip-close', 'mousedown keydown mouseup keyup mouseout', function(event) { $(this).toggleClass('ui-state-active ui-state-focus', event.type.substr(-4) === 'down'); }) .delegate('.ui-tooltip-close', 'mouseover mouseout', function(event){ $(this).toggleClass('ui-state-hover', event.type === 'mouseover'); }); // Create button if enabled if(options.content.title.button) { createButton(); } // Redraw the tooltip dimensions if it's rendered else if(self.rendered){ self.redraw(); } } function updateButton(button) { var elem = elements.button, title = elements.title; // Make sure tooltip is rendered and if not, return if(!self.rendered) { return FALSE; } if(!button) { elem.remove(); } else { if(!title) { createTitle(); } createButton(); } } function updateTitle(content, reposition) { var elem = elements.title; // Make sure tooltip is rendered and if not, return if(!self.rendered || !content) { return FALSE; } // Use function to parse content if($.isFunction(content)) { content = content.call(target, cache.event, self); } // Remove title if callback returns false or null/undefined (but not '') if(content === FALSE || (!content && content !== '')) { return removeTitle(FALSE); } // Append new content if its a DOM array and show it if hidden else if(content.jquery && content.length > 0) { elem.empty().append(content.css({ display: 'block' })); } // Content is a regular string, insert the new content else { elem.html(content); } // Redraw and reposition self.redraw(); if(reposition !== FALSE && self.rendered && tooltip[0].offsetWidth > 0) { self.reposition(cache.event); } } function updateContent(content, reposition) { var elem = elements.content; // Make sure tooltip is rendered and content is defined. If not return if(!self.rendered || !content) { return FALSE; } // Use function to parse content if($.isFunction(content)) { content = content.call(target, cache.event, self) || ''; } // Append new content if its a DOM array and show it if hidden if(content.jquery && content.length > 0) { elem.empty().append(content.css({ display: 'block' })); } // Content is a regular string, insert the new content else { elem.html(content); } // Image detection function detectImages(next) { var images, srcs = {}; function imageLoad(image) { // Clear src from object and any timers and events associated with the image if(image) { delete srcs[image.src]; clearTimeout(self.timers.img[image.src]); $(image).unbind(namespace); } // If queue is empty after image removal, update tooltip and continue the queue if($.isEmptyObject(srcs)) { self.redraw(); if(reposition !== FALSE) { self.reposition(cache.event); } next(); } } // Find all content images without dimensions, and if no images were found, continue if((images = elem.find('img[src]:not([height]):not([width])')).length === 0) { return imageLoad(); } // Apply timer to each image to poll for dimensions images.each(function(i, elem) { // Skip if the src is already present if(srcs[elem.src] !== undefined) { return; } // Keep track of how many times we poll for image dimensions. // If it doesn't return in a reasonable amount of time, it's better // to display the tooltip, rather than hold up the queue. var iterations = 0, maxIterations = 3; (function timer(){ // When the dimensions are found, remove the image from the queue if(elem.height || elem.width || (iterations > maxIterations)) { return imageLoad(elem); } // Increase iterations and restart timer iterations += 1; self.timers.img[elem.src] = setTimeout(timer, 700); }()); // Also apply regular load/error event handlers $(elem).bind('error'+namespace+' load'+namespace, function(){ imageLoad(this); }); // Store the src and element in our object srcs[elem.src] = elem; }); } /* * If we're still rendering... insert into 'fx' queue our image dimension * checker which will halt the showing of the tooltip until image dimensions * can be detected properly. */ if(self.rendered < 0) { tooltip.queue('fx', detectImages); } // We're fully rendered, so reset isDrawing flag and proceed without queue delay else { isDrawing = 0; detectImages($.noop); } return self; } function assignEvents() { var posOptions = options.position, targets = { show: options.show.target, hide: options.hide.target, viewport: $(posOptions.viewport), document: $(document), body: $(document.body), window: $(window) }, events = { show: $.trim('' + options.show.event).split(' '), hide: $.trim('' + options.hide.event).split(' ') }, IE6 = $.browser.msie && parseInt($.browser.version, 10) === 6; // Define show event method function showMethod(event) { if(tooltip.hasClass(disabled)) { return FALSE; } // Clear hide timers clearTimeout(self.timers.show); clearTimeout(self.timers.hide); // Start show timer var callback = function(){ self.toggle(TRUE, event); }; if(options.show.delay > 0) { self.timers.show = setTimeout(callback, options.show.delay); } else{ callback(); } } // Define hide method function hideMethod(event) { if(tooltip.hasClass(disabled) || isPositioning || isDrawing) { return FALSE; } // Check if new target was actually the tooltip element var relatedTarget = $(event.relatedTarget || event.target), ontoTooltip = relatedTarget.closest(selector)[0] === tooltip[0], ontoTarget = relatedTarget[0] === targets.show[0]; // Clear timers and stop animation queue clearTimeout(self.timers.show); clearTimeout(self.timers.hide); // Prevent hiding if tooltip is fixed and event target is the tooltip. Or if mouse positioning is enabled and cursor momentarily overlaps if((posOptions.target === 'mouse' && ontoTooltip) || (options.hide.fixed && ((/mouse(out|leave|move)/).test(event.type) && (ontoTooltip || ontoTarget)))) { try { event.preventDefault(); event.stopImmediatePropagation(); } catch(e) {} return; } // If tooltip has displayed, start hide timer if(options.hide.delay > 0) { self.timers.hide = setTimeout(function(){ self.hide(event); }, options.hide.delay); } else{ self.hide(event); } } // Define inactive method function inactiveMethod(event) { if(tooltip.hasClass(disabled)) { return FALSE; } // Clear timer clearTimeout(self.timers.inactive); self.timers.inactive = setTimeout(function(){ self.hide(event); }, options.hide.inactive); } function repositionMethod(event) { if(self.rendered && tooltip[0].offsetWidth > 0) { self.reposition(event); } } // On mouseenter/mouseleave... tooltip.bind('mouseenter'+namespace+' mouseleave'+namespace, function(event) { var state = event.type === 'mouseenter'; // Focus the tooltip on mouseenter (z-index stacking) if(state) { self.focus(event); } // Add hover class tooltip.toggleClass(hoverClass, state); }); // If using mouseout/mouseleave as a hide event... if(/mouse(out|leave)/i.test(options.hide.event)) { // Hide tooltips when leaving current window/frame (but not select/option elements) if(options.hide.leave === 'window') { targets.window.bind('mouseleave'+namespace+' blur'+namespace, function(event) { if(!/select|option/.test(event.target.nodeName) && !event.relatedTarget) { self.hide(event); } }); } } // Enable hide.fixed if(options.hide.fixed) { // Add tooltip as a hide target targets.hide = targets.hide.add(tooltip); // Clear hide timer on tooltip hover to prevent it from closing tooltip.bind('mouseover'+namespace, function() { if(!tooltip.hasClass(disabled)) { clearTimeout(self.timers.hide); } }); } /* * Make sure hoverIntent functions properly by using mouseleave to clear show timer if * mouseenter/mouseout is used for show.event, even if it isn't in the users options. */ else if(/mouse(over|enter)/i.test(options.show.event)) { targets.hide.bind('mouseleave'+namespace, function(event) { clearTimeout(self.timers.show); }); } // Hide tooltip on document mousedown if unfocus events are enabled if(('' + options.hide.event).indexOf('unfocus') > -1) { posOptions.container.closest('html').bind('mousedown'+namespace, function(event) { var elem = $(event.target), enabled = self.rendered && !tooltip.hasClass(disabled) && tooltip[0].offsetWidth > 0, isAncestor = elem.parents(selector).filter(tooltip[0]).length > 0; if(elem[0] !== target[0] && elem[0] !== tooltip[0] && !isAncestor && !target.has(elem[0]).length && !elem.attr('disabled') ) { self.hide(event); } }); } // Check if the tooltip hides when inactive if('number' === typeof options.hide.inactive) { // Bind inactive method to target as a custom event targets.show.bind('qtip-'+id+'-inactive', inactiveMethod); // Define events which reset the 'inactive' event handler $.each(QTIP.inactiveEvents, function(index, type){ targets.hide.add(elements.tooltip).bind(type+namespace+'-inactive', inactiveMethod); }); } // Apply hide events $.each(events.hide, function(index, type) { var showIndex = $.inArray(type, events.show), targetHide = $(targets.hide); // Both events and targets are identical, apply events using a toggle if((showIndex > -1 && targetHide.add(targets.show).length === targetHide.length) || type === 'unfocus') { targets.show.bind(type+namespace, function(event) { if(tooltip[0].offsetWidth > 0) { hideMethod(event); } else { showMethod(event); } }); // Don't bind the event again delete events.show[ showIndex ]; } // Events are not identical, bind normally else { targets.hide.bind(type+namespace, hideMethod); } }); // Apply show events $.each(events.show, function(index, type) { targets.show.bind(type+namespace, showMethod); }); // Check if the tooltip hides when mouse is moved a certain distance if('number' === typeof options.hide.distance) { // Bind mousemove to target to detect distance difference targets.show.add(tooltip).bind('mousemove'+namespace, function(event) { var origin = cache.origin || {}, limit = options.hide.distance, abs = Math.abs; // Check if the movement has gone beyond the limit, and hide it if so if(abs(event.pageX - origin.pageX) >= limit || abs(event.pageY - origin.pageY) >= limit) { self.hide(event); } }); } // Mouse positioning events if(posOptions.target === 'mouse') { // Cache mousemove coords on show targets targets.show.bind('mousemove'+namespace, function(event) { MOUSE = { pageX: event.pageX, pageY: event.pageY, type: 'mousemove' }; }); // If mouse adjustment is on... if(posOptions.adjust.mouse) { // Apply a mouseleave event so we don't get problems with overlapping if(options.hide.event) { // Hide when we leave the tooltip and not onto the show target tooltip.bind('mouseleave'+namespace, function(event) { if((event.relatedTarget || event.target) !== targets.show[0]) { self.hide(event); } }); // Track if we're on the target or not elements.target.bind('mouseenter'+namespace+' mouseleave'+namespace, function(event) { cache.onTarget = event.type === 'mouseenter'; }); } // Update tooltip position on mousemove targets.document.bind('mousemove'+namespace, function(event) { // Update the tooltip position only if the tooltip is visible and adjustment is enabled if(self.rendered && cache.onTarget && !tooltip.hasClass(disabled) && tooltip[0].offsetWidth > 0) { self.reposition(event || MOUSE); } }); } } // Adjust positions of the tooltip on window resize if enabled if(posOptions.adjust.resize || targets.viewport.length) { ($.event.special.resize ? targets.viewport : targets.window).bind('resize'+namespace, repositionMethod); } // Adjust tooltip position on scroll if screen adjustment is enabled if(targets.viewport.length || (IE6 && tooltip.css('position') === 'fixed')) { targets.viewport.bind('scroll'+namespace, repositionMethod); } } function unassignEvents() { var targets = [ options.show.target[0], options.hide.target[0], self.rendered && elements.tooltip[0], options.position.container[0], options.position.viewport[0], window, document ]; // Check if tooltip is rendered if(self.rendered) { $([]).pushStack( $.grep(targets, function(i){ return typeof i === 'object'; }) ).unbind(namespace); } // Tooltip isn't yet rendered, remove render event else { options.show.target.unbind(namespace+'-create'); } } // Setup builtin .set() option checks self.checks.builtin = { // Core checks '^id$': function(obj, o, v) { var id = v === TRUE ? QTIP.nextid : v, tooltipID = uitooltip + '-' + id; if(id !== FALSE && id.length > 0 && !$('#'+tooltipID).length) { tooltip[0].id = tooltipID; elements.content[0].id = tooltipID + '-content'; elements.title[0].id = tooltipID + '-title'; } }, // Content checks '^content.text$': function(obj, o, v){ updateContent(v); }, '^content.title.text$': function(obj, o, v) { // Remove title if content is null if(!v) { return removeTitle(); } // If title isn't already created, create it now and update if(!elements.title && v) { createTitle(); } updateTitle(v); }, '^content.title.button$': function(obj, o, v){ updateButton(v); }, // Position checks '^position.(my|at)$': function(obj, o, v){ // Parse new corner value into Corner objecct if('string' === typeof v) { obj[o] = new PLUGINS.Corner(v); } }, '^position.container$': function(obj, o, v){ if(self.rendered) { tooltip.appendTo(v); } }, // Show checks '^show.ready$': function() { if(!self.rendered) { self.render(1); } else { self.toggle(TRUE); } }, // Style checks '^style.classes$': function(obj, o, v) { tooltip.attr('class', uitooltip + ' qtip ui-helper-reset ' + v); }, '^style.widget|content.title': setWidget, // Events check '^events.(render|show|move|hide|focus|blur)$': function(obj, o, v) { tooltip[($.isFunction(v) ? '' : 'un') + 'bind']('tooltip'+o, v); }, // Properties which require event reassignment '^(show|hide|position).(event|target|fixed|inactive|leave|distance|viewport|adjust)': function() { var posOptions = options.position; // Set tracking flag tooltip.attr('tracking', posOptions.target === 'mouse' && posOptions.adjust.mouse); // Reassign events unassignEvents(); assignEvents(); } }; /* * Public API methods */ $.extend(self, { render: function(show) { if(self.rendered) { return self; } // If tooltip has already been rendered, exit var text = options.content.text, title = options.content.title.text, posOptions = options.position, callback = $.Event('tooltiprender'); // Add ARIA attributes to target $.attr(target[0], 'aria-describedby', tooltipID); // Create tooltip element tooltip = elements.tooltip = $('
', { 'id': tooltipID, 'class': uitooltip + ' qtip ui-helper-reset ' + defaultClass + ' ' + options.style.classes + ' '+ uitooltip + '-pos-' + options.position.my.abbrev(), 'width': options.style.width || '', 'height': options.style.height || '', 'tracking': posOptions.target === 'mouse' && posOptions.adjust.mouse, /* ARIA specific attributes */ 'role': 'alert', 'aria-live': 'polite', 'aria-atomic': FALSE, 'aria-describedby': tooltipID + '-content', 'aria-hidden': TRUE }) .toggleClass(disabled, cache.disabled) .data('qtip', self) .appendTo(options.position.container) .append( // Create content element elements.content = $('
', { 'class': uitooltip + '-content', 'id': tooltipID + '-content', 'aria-atomic': TRUE }) ); // Set rendered flag and prevent redundant redraw/reposition calls for now self.rendered = -1; isDrawing = 1; isPositioning = 1; // Create title... if(title) { createTitle(); // Update title only if its not a callback (called in toggle if so) if(!$.isFunction(title)) { updateTitle(title, FALSE); } } // Set proper rendered flag and update content if not a callback function (called in toggle) if(!$.isFunction(text)) { updateContent(text, FALSE); } self.rendered = TRUE; // Setup widget classes setWidget(); // Assign passed event callbacks (before plugins!) $.each(options.events, function(name, callback) { if($.isFunction(callback)) { tooltip.bind(name === 'toggle' ? 'tooltipshow tooltiphide' : 'tooltip'+name, callback); } }); // Initialize 'render' plugins $.each(PLUGINS, function() { if(this.initialize === 'render') { this(self); } }); // Assign events assignEvents(); /* Queue this part of the render process in our fx queue so we can * load images before the tooltip renders fully. * * See: updateContent method */ tooltip.queue('fx', function(next) { // Trigger tooltiprender event and pass original triggering event as original callback.originalEvent = cache.event; tooltip.trigger(callback, [self]); // Reset flags isDrawing = 0; isPositioning = 0; // Redraw the tooltip manually now we're fully rendered self.redraw(); // Show tooltip if needed if(options.show.ready || show) { self.toggle(TRUE, cache.event, FALSE); } next(); // Move on to next method in queue }); return self; }, get: function(notation) { var result, o; switch(notation.toLowerCase()) { case 'dimensions': result = { height: tooltip.outerHeight(), width: tooltip.outerWidth() }; break; case 'offset': result = PLUGINS.offset(tooltip, options.position.container); break; default: o = convertNotation(notation.toLowerCase()); result = o[0][ o[1] ]; result = result.precedance ? result.string() : result; break; } return result; }, set: function(option, value) { var rmove = /^position\.(my|at|adjust|target|container)|style|content|show\.ready/i, rdraw = /^content\.(title|attr)|style/i, reposition = FALSE, redraw = FALSE, checks = self.checks, name; function callback(notation, args) { var category, rule, match; for(category in checks) { for(rule in checks[category]) { if(match = (new RegExp(rule, 'i')).exec(notation)) { args.push(match); checks[category][rule].apply(self, args); } } } } // Convert singular option/value pair into object form if('string' === typeof option) { name = option; option = {}; option[name] = value; } else { option = $.extend(TRUE, {}, option); } // Set all of the defined options to their new values $.each(option, function(notation, value) { var obj = convertNotation( notation.toLowerCase() ), previous; // Set new obj value previous = obj[0][ obj[1] ]; obj[0][ obj[1] ] = 'object' === typeof value && value.nodeType ? $(value) : value; // Set the new params for the callback option[notation] = [obj[0], obj[1], value, previous]; // Also check if we need to reposition / redraw reposition = rmove.test(notation) || reposition; redraw = rdraw.test(notation) || redraw; }); // Re-sanitize options sanitizeOptions(options); /* * Execute any valid callbacks for the set options * Also set isPositioning/isDrawing so we don't get loads of redundant repositioning * and redraw calls. */ isPositioning = isDrawing = 1; $.each(option, callback); isPositioning = isDrawing = 0; // Update position / redraw if needed if(self.rendered && tooltip[0].offsetWidth > 0) { if(reposition) { self.reposition( options.position.target === 'mouse' ? NULL : cache.event ); } if(redraw) { self.redraw(); } } return self; }, toggle: function(state, event) { // Render the tooltip if showing and it isn't already if(!self.rendered) { return state ? self.render(1) : self; } var type = state ? 'show' : 'hide', opts = options[type], otherOpts = options[ !state ? 'show' : 'hide' ], posOptions = options.position, contentOptions = options.content, visible = tooltip[0].offsetWidth > 0, animate = state || opts.target.length === 1, sameTarget = !event || opts.target.length < 2 || cache.target[0] === event.target, delay, callback; // Detect state if valid one isn't provided if((typeof state).search('boolean|number')) { state = !visible; } // Return if element is already in correct state if(!tooltip.is(':animated') && visible === state && sameTarget) { return self; } // Try to prevent flickering when tooltip overlaps show element if(event) { if((/over|enter/).test(event.type) && (/out|leave/).test(cache.event.type) && options.show.target.add(event.target).length === options.show.target.length && tooltip.has(event.relatedTarget).length) { return self; } // Cache event cache.event = $.extend({}, event); } // Call API methods callback = $.Event('tooltip'+type); callback.originalEvent = event ? cache.event : NULL; tooltip.trigger(callback, [self, 90]); if(callback.isDefaultPrevented()){ return self; } // Set ARIA hidden status attribute $.attr(tooltip[0], 'aria-hidden', !!!state); // Execute state specific properties if(state) { // Store show origin coordinates cache.origin = $.extend({}, MOUSE); // Focus the tooltip self.focus(event); // Update tooltip content & title if it's a dynamic function if($.isFunction(contentOptions.text)) { updateContent(contentOptions.text, FALSE); } if($.isFunction(contentOptions.title.text)) { updateTitle(contentOptions.title.text, FALSE); } // Cache mousemove events for positioning purposes (if not already tracking) if(!trackingBound && posOptions.target === 'mouse' && posOptions.adjust.mouse) { $(document).bind('mousemove.qtip', function(event) { MOUSE = { pageX: event.pageX, pageY: event.pageY, type: 'mousemove' }; }); trackingBound = TRUE; } // Update the tooltip position self.reposition(event, arguments[2]); // Hide other tooltips if tooltip is solo, using it as the context if((callback.solo = !!opts.solo)) { $(selector, opts.solo).not(tooltip).qtip('hide', callback); } } else { // Clear show timer if we're hiding clearTimeout(self.timers.show); // Remove cached origin on hide delete cache.origin; // Remove mouse tracking event if not needed (all tracking qTips are hidden) if(trackingBound && !$(selector+'[tracking="true"]:visible', opts.solo).not(tooltip).length) { $(document).unbind('mousemove.qtip'); trackingBound = FALSE; } // Blur the tooltip self.blur(event); } // Define post-animation, state specific properties function after() { if(state) { // Prevent antialias from disappearing in IE by removing filter if($.browser.msie) { tooltip[0].style.removeAttribute('filter'); } // Remove overflow setting to prevent tip bugs tooltip.css('overflow', ''); // Autofocus elements if enabled if('string' === typeof opts.autofocus) { $(opts.autofocus, tooltip).focus(); } // If set, hide tooltip when inactive for delay period opts.target.trigger('qtip-'+id+'-inactive'); } else { // Reset CSS states tooltip.css({ display: '', visibility: '', opacity: '', left: '', top: '' }); } // Call API method callback = $.Event('tooltip'+(state ? 'visible' : 'hidden')); callback.originalEvent = event ? cache.event : NULL; tooltip.trigger(callback, [self]); } // If no effect type is supplied, use a simple toggle if(opts.effect === FALSE || animate === FALSE) { tooltip[ type ](); after.call(tooltip); } // Use custom function if provided else if($.isFunction(opts.effect)) { tooltip.stop(1, 1); opts.effect.call(tooltip, self); tooltip.queue('fx', function(n){ after(); n(); }); } // Use basic fade function by default else { tooltip.fadeTo(90, state ? 1 : 0, after); } // If inactive hide method is set, active it if(state) { opts.target.trigger('qtip-'+id+'-inactive'); } return self; }, show: function(event){ return self.toggle(TRUE, event); }, hide: function(event){ return self.toggle(FALSE, event); }, focus: function(event) { if(!self.rendered) { return self; } var qtips = $(selector), curIndex = parseInt(tooltip[0].style.zIndex, 10), newIndex = QTIP.zindex + qtips.length, cachedEvent = $.extend({}, event), focusedElem, callback; // Only update the z-index if it has changed and tooltip is not already focused if(!tooltip.hasClass(focusClass)) { // Call API method callback = $.Event('tooltipfocus'); callback.originalEvent = cachedEvent; tooltip.trigger(callback, [self, newIndex]); // If default action wasn't prevented... if(!callback.isDefaultPrevented()) { // Only update z-index's if they've changed if(curIndex !== newIndex) { // Reduce our z-index's and keep them properly ordered qtips.each(function() { if(this.style.zIndex > curIndex) { this.style.zIndex = this.style.zIndex - 1; } }); // Fire blur event for focused tooltip qtips.filter('.' + focusClass).qtip('blur', cachedEvent); } // Set the new z-index tooltip.addClass(focusClass)[0].style.zIndex = newIndex; } } return self; }, blur: function(event) { var cachedEvent = $.extend({}, event), callback; // Set focused status to FALSE tooltip.removeClass(focusClass); // Trigger blur event callback = $.Event('tooltipblur'); callback.originalEvent = cachedEvent; tooltip.trigger(callback, [self]); return self; }, reposition: function(event, effect) { if(!self.rendered || isPositioning) { return self; } // Set positioning flag isPositioning = 1; var target = options.position.target, posOptions = options.position, my = posOptions.my, at = posOptions.at, adjust = posOptions.adjust, method = adjust.method.split(' '), elemWidth = tooltip.outerWidth(), elemHeight = tooltip.outerHeight(), targetWidth = 0, targetHeight = 0, callback = $.Event('tooltipmove'), fixed = tooltip.css('position') === 'fixed', viewport = posOptions.viewport, position = { left: 0, top: 0 }, container = posOptions.container, visible = tooltip[0].offsetWidth > 0, adjusted, offset, win; // Check if absolute position was passed if($.isArray(target) && target.length === 2) { // Force left top and set position at = { x: LEFT, y: TOP }; position = { left: target[0], top: target[1] }; } // Check if mouse was the target else if(target === 'mouse' && ((event && event.pageX) || cache.event.pageX)) { // Force left top to allow flipping at = { x: LEFT, y: TOP }; // Use cached event if one isn't available for positioning event = (event && (event.type === 'resize' || event.type === 'scroll') ? cache.event : event && event.pageX && event.type === 'mousemove' ? event : MOUSE && MOUSE.pageX && (adjust.mouse || !event || !event.pageX) ? { pageX: MOUSE.pageX, pageY: MOUSE.pageY } : !adjust.mouse && cache.origin && cache.origin.pageX && options.show.distance ? cache.origin : event) || event || cache.event || MOUSE || {}; // Use event coordinates for position position = { top: event.pageY, left: event.pageX }; } // Target wasn't mouse or absolute... else { // Check if event targetting is being used if(target === 'event' && event && event.target && event.type !== 'scroll' && event.type !== 'resize') { cache.target = $(event.target); } else if(target !== 'event'){ cache.target = $(target.jquery ? target : elements.target); } target = cache.target; // Parse the target into a jQuery object and make sure there's an element present target = $(target).eq(0); if(target.length === 0) { return self; } // Check if window or document is the target else if(target[0] === document || target[0] === window) { targetWidth = PLUGINS.iOS ? window.innerWidth : target.width(); targetHeight = PLUGINS.iOS ? window.innerHeight : target.height(); if(target[0] === window) { position = { top: (viewport || target).scrollTop(), left: (viewport || target).scrollLeft() }; } } // Use Imagemap/SVG plugins if needed else if(PLUGINS.imagemap && target.is('area')) { adjusted = PLUGINS.imagemap(self, target, at, PLUGINS.viewport ? method : FALSE); } else if(PLUGINS.svg && typeof target[0].xmlbase === 'string') { adjusted = PLUGINS.svg(self, target, at, PLUGINS.viewport ? method : FALSE); } else { targetWidth = target.outerWidth(); targetHeight = target.outerHeight(); position = PLUGINS.offset(target, container); } // Parse returned plugin values into proper variables if(adjusted) { targetWidth = adjusted.width; targetHeight = adjusted.height; offset = adjusted.offset; position = adjusted.position; } // Adjust for position.fixed tooltips (and also iOS scroll bug in v3.2-4.0 & v4.3-4.3.2) if((PLUGINS.iOS > 3.1 && PLUGINS.iOS < 4.1) || (PLUGINS.iOS >= 4.3 && PLUGINS.iOS < 4.33) || (!PLUGINS.iOS && fixed) ){ win = $(window); position.left -= win.scrollLeft(); position.top -= win.scrollTop(); } // Adjust position relative to target position.left += at.x === RIGHT ? targetWidth : at.x === CENTER ? targetWidth / 2 : 0; position.top += at.y === BOTTOM ? targetHeight : at.y === CENTER ? targetHeight / 2 : 0; } // Adjust position relative to tooltip position.left += adjust.x + (my.x === RIGHT ? -elemWidth : my.x === CENTER ? -elemWidth / 2 : 0); position.top += adjust.y + (my.y === BOTTOM ? -elemHeight : my.y === CENTER ? -elemHeight / 2 : 0); // Use viewport adjustment plugin if enabled if(PLUGINS.viewport) { position.adjusted = PLUGINS.viewport( self, position, posOptions, targetWidth, targetHeight, elemWidth, elemHeight ); // Apply offsets supplied by positioning plugin (if used) if(offset && position.adjusted.left) { position.left += offset.left; } if(offset && position.adjusted.top) { position.top += offset.top; } } // Viewport adjustment is disabled, set values to zero else { position.adjusted = { left: 0, top: 0 }; } // Call API method callback.originalEvent = $.extend({}, event); tooltip.trigger(callback, [self, position, viewport.elem || viewport]); if(callback.isDefaultPrevented()){ return self; } delete position.adjusted; // If effect is disabled, target it mouse, no animation is defined or positioning gives NaN out, set CSS directly if(effect === FALSE || !visible || isNaN(position.left) || isNaN(position.top) || target === 'mouse' || !$.isFunction(posOptions.effect)) { tooltip.css(position); } // Use custom function if provided else if($.isFunction(posOptions.effect)) { posOptions.effect.call(tooltip, self, $.extend({}, position)); tooltip.queue(function(next) { // Reset attributes to avoid cross-browser rendering bugs $(this).css({ opacity: '', height: '' }); if($.browser.msie) { this.style.removeAttribute('filter'); } next(); }); } // Set positioning flag isPositioning = 0; return self; }, // Max/min width simulator function for all browsers.. yeaaah! redraw: function() { if(self.rendered < 1 || isDrawing) { return self; } var container = options.position.container, perc, width, max, min; // Set drawing flag isDrawing = 1; // If tooltip has a set height, just set it... like a boss! if(options.style.height) { tooltip.css(HEIGHT, options.style.height); } // If tooltip has a set width, just set it... like a boss! if(options.style.width) { tooltip.css(WIDTH, options.style.width); } // Otherwise simualte max/min width... else { // Reset width and add fluid class tooltip.css(WIDTH, '').addClass(fluidClass); // Grab our tooltip width (add 1 so we don't get wrapping problems.. huzzah!) width = tooltip.width() + 1; // Grab our max/min properties max = tooltip.css('max-width') || ''; min = tooltip.css('min-width') || ''; // Parse into proper pixel values perc = (max + min).indexOf('%') > -1 ? container.width() / 100 : 0; max = ((max.indexOf('%') > -1 ? perc : 1) * parseInt(max, 10)) || width; min = ((min.indexOf('%') > -1 ? perc : 1) * parseInt(min, 10)) || 0; // Determine new dimension size based on max/min/current values width = max + min ? Math.min(Math.max(width, min), max) : width; // Set the newly calculated width and remvoe fluid class tooltip.css(WIDTH, Math.round(width)).removeClass(fluidClass); } // Set drawing flag isDrawing = 0; return self; }, disable: function(state) { if('boolean' !== typeof state) { state = !(tooltip.hasClass(disabled) || cache.disabled); } if(self.rendered) { tooltip.toggleClass(disabled, state); $.attr(tooltip[0], 'aria-disabled', state); } else { cache.disabled = !!state; } return self; }, enable: function() { return self.disable(FALSE); }, destroy: function() { var t = target[0], title = $.attr(t, oldtitle), elemAPI = target.data('qtip'); // Set flag the signify destroy is taking place to plugins self.destroyed = TRUE; // Destroy tooltip and any associated plugins if rendered if(self.rendered) { tooltip.stop(1,0).remove(); $.each(self.plugins, function() { if(this.destroy) { this.destroy(); } }); } // Clear timers and remove bound events clearTimeout(self.timers.show); clearTimeout(self.timers.hide); unassignEvents(); // If the API if actually this qTip API... if(!elemAPI || self === elemAPI) { // Remove api object $.removeData(t, 'qtip'); // Reset old title attribute if removed if(options.suppress && title) { $.attr(t, 'title', title); target.removeAttr(oldtitle); } // Remove ARIA attributes target.removeAttr('aria-describedby'); } // Remove qTip events associated with this API target.unbind('.qtip-'+id); // Remove ID from sued id object delete usedIDs[self.id]; return target; } }); } // Initialization method function init(id, opts) { var obj, posOptions, attr, config, title, // Setup element references elem = $(this), docBody = $(document.body), // Use document body instead of document element if needed newTarget = this === document ? docBody : elem, // Grab metadata from element if plugin is present metadata = (elem.metadata) ? elem.metadata(opts.metadata) : NULL, // If metadata type if HTML5, grab 'name' from the object instead, or use the regular data object otherwise metadata5 = opts.metadata.type === 'html5' && metadata ? metadata[opts.metadata.name] : NULL, // Grab data from metadata.name (or data-qtipopts as fallback) using .data() method, html5 = elem.data(opts.metadata.name || 'qtipopts'); // If we don't get an object returned attempt to parse it manualyl without parseJSON try { html5 = typeof html5 === 'string' ? (new Function("return " + html5))() : html5; } catch(e) { log('Unable to parse HTML5 attribute data: ' + html5); } // Merge in and sanitize metadata config = $.extend(TRUE, {}, QTIP.defaults, opts, typeof html5 === 'object' ? sanitizeOptions(html5) : NULL, sanitizeOptions(metadata5 || metadata)); // Re-grab our positioning options now we've merged our metadata and set id to passed value posOptions = config.position; config.id = id; // Setup missing content if none is detected if('boolean' === typeof config.content.text) { attr = elem.attr(config.content.attr); // Grab from supplied attribute if available if(config.content.attr !== FALSE && attr) { config.content.text = attr; } // No valid content was found, abort render else { log('Unable to locate content for tooltip! Aborting render of tooltip on element: ', elem); return FALSE; } } // Setup target options if(!posOptions.container.length) { posOptions.container = docBody; } if(posOptions.target === FALSE) { posOptions.target = newTarget; } if(config.show.target === FALSE) { config.show.target = newTarget; } if(config.show.solo === TRUE) { config.show.solo = posOptions.container.closest('body'); } if(config.hide.target === FALSE) { config.hide.target = newTarget; } if(config.position.viewport === TRUE) { config.position.viewport = posOptions.container; } // Ensure we only use a single container posOptions.container = posOptions.container.eq(0); // Convert position corner values into x and y strings posOptions.at = new PLUGINS.Corner(posOptions.at); posOptions.my = new PLUGINS.Corner(posOptions.my); // Destroy previous tooltip if overwrite is enabled, or skip element if not if($.data(this, 'qtip')) { if(config.overwrite) { elem.qtip('destroy'); } else if(config.overwrite === FALSE) { return FALSE; } } // Remove title attribute and store it if present if(config.suppress && (title = $.attr(this, 'title'))) { // Final attr call fixes event delegatiom and IE default tooltip showing problem $(this).removeAttr('title').attr(oldtitle, title).attr('title', ''); } // Initialize the tooltip and add API reference obj = new QTip(elem, config, id, !!attr); $.data(this, 'qtip', obj); // Catch remove/removeqtip events on target element to destroy redundant tooltip elem.bind('remove.qtip-'+id+' removeqtip.qtip-'+id, function(){ obj.destroy(); }); return obj; } // jQuery $.fn extension method QTIP = $.fn.qtip = function(options, notation, newValue) { var command = ('' + options).toLowerCase(), // Parse command returned = NULL, args = $.makeArray(arguments).slice(1), event = args[args.length - 1], opts = this[0] ? $.data(this[0], 'qtip') : NULL; // Check for API request if((!arguments.length && opts) || command === 'api') { return opts; } // Execute API command if present else if('string' === typeof options) { this.each(function() { var api = $.data(this, 'qtip'); if(!api) { return TRUE; } // Cache the event if possible if(event && event.timeStamp) { api.cache.event = event; } // Check for specific API commands if((command === 'option' || command === 'options') && notation) { if($.isPlainObject(notation) || newValue !== undefined) { api.set(notation, newValue); } else { returned = api.get(notation); return FALSE; } } // Execute API command else if(api[command]) { api[command].apply(api[command], args); } }); return returned !== NULL ? returned : this; } // No API commands. validate provided options and setup qTips else if('object' === typeof options || !arguments.length) { opts = sanitizeOptions($.extend(TRUE, {}, options)); // Bind the qTips return QTIP.bind.call(this, opts, event); } }; // $.fn.qtip Bind method QTIP.bind = function(opts, event) { return this.each(function(i) { var options, targets, events, namespace, api, id; // Find next available ID, or use custom ID if provided id = $.isArray(opts.id) ? opts.id[i] : opts.id; id = !id || id === FALSE || id.length < 1 || usedIDs[id] ? QTIP.nextid++ : (usedIDs[id] = id); // Setup events namespace namespace = '.qtip-'+id+'-create'; // Initialize the qTip and re-grab newly sanitized options api = init.call(this, id, opts); if(api === FALSE) { return TRUE; } options = api.options; // Initialize plugins $.each(PLUGINS, function() { if(this.initialize === 'initialize') { this(api); } }); // Determine hide and show targets targets = { show: options.show.target, hide: options.hide.target }; events = { show: $.trim('' + options.show.event).replace(/ /g, namespace+' ') + namespace, hide: $.trim('' + options.hide.event).replace(/ /g, namespace+' ') + namespace }; /* * Make sure hoverIntent functions properly by using mouseleave as a hide event if * mouseenter/mouseout is used for show.event, even if it isn't in the users options. */ if(/mouse(over|enter)/i.test(events.show) && !/mouse(out|leave)/i.test(events.hide)) { events.hide += ' mouseleave' + namespace; } /* * Also make sure initial mouse targetting works correctly by caching mousemove coords * on show targets before the tooltip has rendered. * * Also set onTarget when triggered to keep mouse tracking working */ targets.show.bind('mousemove'+namespace, function(event) { MOUSE = { pageX: event.pageX, pageY: event.pageY, type: 'mousemove' }; api.cache.onTarget = TRUE; }); // Define hoverIntent function function hoverIntent(event) { function render() { // Cache mouse coords,render and render the tooltip api.render(typeof event === 'object' || options.show.ready); // Unbind show and hide events targets.show.add(targets.hide).unbind(namespace); } // Only continue if tooltip isn't disabled if(api.cache.disabled) { return FALSE; } // Cache the event data api.cache.event = $.extend({}, event); api.cache.target = event ? $(event.target) : [undefined]; // Start the event sequence if(options.show.delay > 0) { clearTimeout(api.timers.show); api.timers.show = setTimeout(render, options.show.delay); if(events.show !== events.hide) { targets.hide.bind(events.hide, function() { clearTimeout(api.timers.show); }); } } else { render(); } } // Bind show events to target targets.show.bind(events.show, hoverIntent); // Prerendering is enabled, create tooltip now if(options.show.ready || options.prerender) { hoverIntent(event); } }); }; // Setup base plugins PLUGINS = QTIP.plugins = { // Corner object parser Corner: function(corner) { corner = ('' + corner).replace(/([A-Z])/, ' $1').replace(/middle/gi, CENTER).toLowerCase(); this.x = (corner.match(/left|right/i) || corner.match(/center/) || ['inherit'])[0].toLowerCase(); this.y = (corner.match(/top|bottom|center/i) || ['inherit'])[0].toLowerCase(); var f = corner.charAt(0); this.precedance = (f === 't' || f === 'b' ? Y : X); this.string = function() { return this.precedance === Y ? this.y+this.x : this.x+this.y; }; this.abbrev = function() { var x = this.x.substr(0,1), y = this.y.substr(0,1); return x === y ? x : this.precedance === Y ? y + x : x + y; }; this.invertx = function(center) { this.x = this.x === LEFT ? RIGHT : this.x === RIGHT ? LEFT : center || this.x; }; this.inverty = function(center) { this.y = this.y === TOP ? BOTTOM : this.y === BOTTOM ? TOP : center || this.y; }; this.clone = function() { return { x: this.x, y: this.y, precedance: this.precedance, string: this.string, abbrev: this.abbrev, clone: this.clone, invertx: this.invertx, inverty: this.inverty }; }; }, // Custom (more correct for qTip!) offset calculator offset: function(elem, container) { var pos = elem.offset(), docBody = elem.closest('body')[0], parent = container, scrolled, coffset, overflow; function scroll(e, i) { pos.left += i * e.scrollLeft(); pos.top += i * e.scrollTop(); } if(parent) { // Compensate for non-static containers offset do { if(parent.css('position') !== 'static') { coffset = parent.position(); // Account for element positioning, borders and margins pos.left -= coffset.left + (parseInt(parent.css('borderLeftWidth'), 10) || 0) + (parseInt(parent.css('marginLeft'), 10) || 0); pos.top -= coffset.top + (parseInt(parent.css('borderTopWidth'), 10) || 0) + (parseInt(parent.css('marginTop'), 10) || 0); // If this is the first parent element with an overflow of "scroll" or "auto", store it if(!scrolled && (overflow = parent.css('overflow')) !== 'hidden' && overflow !== 'visible') { scrolled = parent; } } } while((parent = $(parent[0].offsetParent)).length); // Compensate for containers scroll if it also has an offsetParent if(scrolled && scrolled[0] !== docBody) { scroll( scrolled, 1 ); } } return pos; }, /* * iOS version detection */ iOS: parseFloat( ('' + (/CPU.*OS ([0-9_]{1,5})|(CPU like).*AppleWebKit.*Mobile/i.exec(navigator.userAgent) || [0,''])[1]) .replace('undefined', '3_2').replace('_', '.').replace('_', '') ) || FALSE, /* * jQuery-specific $.fn overrides */ fn: { /* Allow other plugins to successfully retrieve the title of an element with a qTip applied */ attr: function(attr, val) { if(this.length) { var self = this[0], title = 'title', api = $.data(self, 'qtip'); if(attr === title && api && 'object' === typeof api && api.options.suppress) { if(arguments.length < 2) { return $.attr(self, oldtitle); } else { // If qTip is rendered and title was originally used as content, update it if(api && api.options.content.attr === title && api.cache.attr) { api.set('content.text', val); } // Use the regular attr method to set, then cache the result return this.attr(oldtitle, val); } } } return $.fn['attr'+replaceSuffix].apply(this, arguments); }, /* Allow clone to correctly retrieve cached title attributes */ clone: function(keepData) { var titles = $([]), title = 'title', // Clone our element using the real clone method elems = $.fn['clone'+replaceSuffix].apply(this, arguments); // Grab all elements with an oldtitle set, and change it to regular title attribute, if keepData is false if(!keepData) { elems.filter('['+oldtitle+']').attr('title', function() { return $.attr(this, oldtitle); }) .removeAttr(oldtitle); } return elems; } } }; // Apply the fn overrides above $.each(PLUGINS.fn, function(name, func) { if(!func || $.fn[name+replaceSuffix]) { return TRUE; } var old = $.fn[name+replaceSuffix] = $.fn[name]; $.fn[name] = function() { return func.apply(this, arguments) || old.apply(this, arguments); }; }); /* Fire off 'removeqtip' handler in $.cleanData if jQuery UI not present (it already does similar). * This snippet is taken directly from jQuery UI source code found here: * http://code.jquery.com/ui/jquery-ui-git.js */ if(!$.ui) { $['cleanData'+replaceSuffix] = $.cleanData; $.cleanData = function( elems ) { for(var i = 0, elem; (elem = elems[i]) !== undefined; i++) { try { $( elem ).triggerHandler('removeqtip'); } catch( e ) {} } $['cleanData'+replaceSuffix]( elems ); }; } // Set global qTip properties QTIP.version = 'nightly'; QTIP.nextid = 0; QTIP.inactiveEvents = 'click dblclick mousedown mouseup mousemove mouseleave mouseenter'.split(' '); QTIP.zindex = 15000; // Define configuration defaults QTIP.defaults = { prerender: FALSE, id: FALSE, overwrite: TRUE, suppress: TRUE, content: { text: TRUE, attr: 'title', title: { text: FALSE, button: FALSE } }, position: { my: 'top left', at: 'bottom right', target: FALSE, container: FALSE, viewport: FALSE, adjust: { x: 0, y: 0, mouse: TRUE, resize: TRUE, method: 'flip flip' }, effect: function(api, pos, viewport) { $(this).animate(pos, { duration: 200, queue: FALSE }); } }, show: { target: FALSE, event: 'mouseenter', effect: TRUE, delay: 90, solo: FALSE, ready: FALSE, autofocus: FALSE }, hide: { target: FALSE, event: 'mouseleave', effect: TRUE, delay: 0, fixed: FALSE, inactive: FALSE, leave: 'window', distance: FALSE }, style: { classes: '', widget: FALSE, width: FALSE, height: FALSE, def: TRUE }, events: { render: NULL, move: NULL, show: NULL, hide: NULL, toggle: NULL, visible: NULL, hidden: NULL, focus: NULL, blur: NULL } }; function Ajax(api) { var self = this, tooltip = api.elements.tooltip, opts = api.options.content.ajax, defaults = QTIP.defaults.content.ajax, namespace = '.qtip-ajax', rscript = /)<[^<]*)*<\/script>/gi, first = TRUE, stop = FALSE, xhr; api.checks.ajax = { '^content.ajax': function(obj, name, v) { // If content.ajax object was reset, set our local var if(name === 'ajax') { opts = v; } if(name === 'once') { self.init(); } else if(opts && opts.url) { self.load(); } else { tooltip.unbind(namespace); } } }; $.extend(self, { init: function() { // Make sure ajax options are enabled and bind event if(opts && opts.url) { tooltip.unbind(namespace)[ opts.once ? 'one' : 'bind' ]('tooltipshow'+namespace, self.load); } return self; }, load: function(event) { if(stop) {stop = FALSE; return; } var hasSelector = opts.url.indexOf(' '), url = opts.url, selector, hideFirst = !opts.loading && first; // If loading option is disabled, prevent the tooltip showing until we've completed the request if(hideFirst) { try{ event.preventDefault(); } catch(e) {} } // Make sure default event hasn't been prevented else if(event && event.isDefaultPrevented()) { return self; } // Cancel old request if(xhr && xhr.abort) { xhr.abort(); } // Check if user delcared a content selector like in .load() if(hasSelector > -1) { selector = url.substr(hasSelector); url = url.substr(0, hasSelector); } // Define common after callback for both success/error handlers function after() { var complete; // Don't proceed if tooltip is destroyed if(api.destroyed) { return; } // Set first flag to false first = FALSE; // Re-display tip if loading and first time, and reset first flag if(hideFirst) { stop = TRUE; api.show(event.originalEvent); } // Call users complete method if it was defined if((complete = defaults.complete || opts.complete) && $.isFunction(complete)) { complete.apply(opts.context || api, arguments); } } // Define success handler function successHandler(content, status, jqXHR) { var success; // Don't proceed if tooltip is destroyed if(api.destroyed) { return; } if(selector) { // Create a dummy div to hold the results and grab the selector element content = $('
') // inject the contents of the document in, removing the scripts // to avoid any 'Permission Denied' errors in IE .append(content.replace(rscript, "")) // Locate the specified elements .find(selector); } // Call the success function if one is defined if((success = defaults.success || opts.success) && $.isFunction(success)) { success.call(opts.context || api, content, status, jqXHR); } // Otherwise set the content else { api.set('content.text', content); } } // Error handler function errorHandler(xhr, status, error) { if(api.destroyed || xhr.status === 0) { return; } api.set('content.text', status + ': ' + error); } // Setup $.ajax option object and process the request xhr = $.ajax( $.extend({ error: defaults.error || errorHandler, context: api }, opts, { url: url, success: successHandler, complete: after }) ); }, destroy: function() { // Cancel ajax request if possible if(xhr && xhr.abort) { xhr.abort(); } // Set api.destroyed flag api.destroyed = TRUE; } }); self.init(); } PLUGINS.ajax = function(api) { var self = api.plugins.ajax; return 'object' === typeof self ? self : (api.plugins.ajax = new Ajax(api)); }; PLUGINS.ajax.initialize = 'render'; // Setup plugin sanitization PLUGINS.ajax.sanitize = function(options) { var content = options.content, opts; if(content && 'ajax' in content) { opts = content.ajax; if(typeof opts !== 'object') { opts = options.content.ajax = { url: opts }; } if('boolean' !== typeof opts.once && opts.once) { opts.once = !!opts.once; } } }; // Extend original api defaults $.extend(TRUE, QTIP.defaults, { content: { ajax: { loading: TRUE, once: TRUE } } }); PLUGINS.viewport = function(api, position, posOptions, targetWidth, targetHeight, elemWidth, elemHeight) { var target = posOptions.target, tooltip = api.elements.tooltip, my = posOptions.my, at = posOptions.at, adjust = posOptions.adjust, method = adjust.method.split(' '), methodX = method[0], methodY = method[1] || method[0], viewport = posOptions.viewport, container = posOptions.container, cache = api.cache, tip = api.plugins.tip, adjusted = { left: 0, top: 0 }, fixed, newMy, newClass; // If viewport is not a jQuery element, or it's the window/document or no adjustment method is used... return if(!viewport.jquery || target[0] === window || target[0] === document.body || adjust.method === 'none') { return adjusted; } // Cache our viewport details fixed = tooltip.css('position') === 'fixed'; viewport = { elem: viewport, height: viewport[ (viewport[0] === window ? 'h' : 'outerH') + 'eight' ](), width: viewport[ (viewport[0] === window ? 'w' : 'outerW') + 'idth' ](), scrollleft: fixed ? 0 : viewport.scrollLeft(), scrolltop: fixed ? 0 : viewport.scrollTop(), offset: viewport.offset() || { left: 0, top: 0 } }; container = { elem: container, scrollLeft: container.scrollLeft(), scrollTop: container.scrollTop(), offset: container.offset() || { left: 0, top: 0 } }; // Generic calculation method function calculate(side, otherSide, type, adjust, side1, side2, lengthName, targetLength, elemLength) { var initialPos = position[side1], mySide = my[side], atSide = at[side], isShift = type === SHIFT, viewportScroll = -container.offset[side1] + viewport.offset[side1] + viewport['scroll'+side1], myLength = mySide === side1 ? elemLength : mySide === side2 ? -elemLength : -elemLength / 2, atLength = atSide === side1 ? targetLength : atSide === side2 ? -targetLength : -targetLength / 2, tipLength = tip && tip.size ? tip.size[lengthName] || 0 : 0, tipAdjust = tip && tip.corner && tip.corner.precedance === side && !isShift ? tipLength : 0, overflow1 = viewportScroll - initialPos + tipAdjust, overflow2 = initialPos + elemLength - viewport[lengthName] - viewportScroll + tipAdjust, offset = myLength - (my.precedance === side || mySide === my[otherSide] ? atLength : 0) - (atSide === CENTER ? targetLength / 2 : 0); // shift if(isShift) { tipAdjust = tip && tip.corner && tip.corner.precedance === otherSide ? tipLength : 0; offset = (mySide === side1 ? 1 : -1) * myLength - tipAdjust; // Adjust position but keep it within viewport dimensions position[side1] += overflow1 > 0 ? overflow1 : overflow2 > 0 ? -overflow2 : 0; position[side1] = Math.max( -container.offset[side1] + viewport.offset[side1] + (tipAdjust && tip.corner[side] === CENTER ? tip.offset : 0), initialPos - offset, Math.min( Math.max(-container.offset[side1] + viewport.offset[side1] + viewport[lengthName], initialPos + offset), position[side1] ) ); } // flip/flipinvert else { // Update adjustment amount depending on if using flipinvert or flip adjust *= (type === FLIPINVERT ? 2 : 0); // Check for overflow on the left/top if(overflow1 > 0 && (mySide !== side1 || overflow2 > 0)) { position[side1] -= offset + adjust; newMy['invert'+side](side1); } // Check for overflow on the bottom/right else if(overflow2 > 0 && (mySide !== side2 || overflow1 > 0) ) { position[side1] -= (mySide === CENTER ? -offset : offset) + adjust; newMy['invert'+side](side2); } // Make sure we haven't made things worse with the adjustment and reset if so if(position[side1] < viewportScroll && -position[side1] > overflow2) { position[side1] = initialPos; newMy = undefined; } } return position[side1] - initialPos; } // Set newMy if using flip or flipinvert methods if(methodX !== 'shift' || methodY !== 'shift') { newMy = my.clone(); } // Adjust position based onviewport and adjustment options adjusted = { left: methodX !== 'none' ? calculate( X, Y, methodX, adjust.x, LEFT, RIGHT, WIDTH, targetWidth, elemWidth ) : 0, top: methodY !== 'none' ? calculate( Y, X, methodY, adjust.y, TOP, BOTTOM, HEIGHT, targetHeight, elemHeight ) : 0 }; // Set tooltip position class if it's changed if(newMy && cache.lastClass !== (newClass = uitooltip + '-pos-' + newMy.abbrev())) { tooltip.removeClass(api.cache.lastClass).addClass( (api.cache.lastClass = newClass) ); } return adjusted; };function Modal(api) { var self = this, options = api.options.show.modal, elems = api.elements, tooltip = elems.tooltip, overlaySelector = '#qtip-overlay', globalNamespace = '.qtipmodal', namespace = globalNamespace + api.id, attr = 'is-modal-qtip', docBody = $(document.body), focusableSelector = PLUGINS.modal.focusable.join(','), focusableElems = {}, overlay; // Setup option set checks api.checks.modal = { '^show.modal.(on|blur)$': function() { // Initialise self.init(); // Show the modal if not visible already and tooltip is visible elems.overlay.toggle( tooltip.is(':visible') ); }, '^content.text$': updateFocusable }; function updateFocusable() { focusableElems = $(focusableSelector, tooltip).not('[disabled]').map(function() { return typeof this.focus === 'function' ? this : null; }); } function focusInputs(blurElems) { // Blurring body element in IE causes window.open windows to unfocus! if(focusableElems.length < 1 && blurElems.length) { blurElems.not('body').blur(); } // Focus the inputs else { focusableElems.first().focus(); } } function stealFocus(event) { var target = $(event.target), container = target.closest('.qtip'), targetOnTop; // Determine if input container target is above this targetOnTop = container.length < 1 ? FALSE : (parseInt(container[0].style.zIndex, 10) > parseInt(tooltip[0].style.zIndex, 10)); // If we're showing a modal, but focus has landed on an input below // this modal, divert focus to the first visible input in this modal // or if we can't find one... the tooltip itself if(!targetOnTop && ($(event.target).closest(selector)[0] !== tooltip[0])) { focusInputs(target); } } $.extend(self, { init: function() { // If modal is disabled... return if(!options.on) { return self; } // Create the overlay if needed overlay = self.create(); // Add unique attribute so we can grab modal tooltips easily via a selector tooltip.attr(attr, TRUE) // Set z-index .css('z-index', PLUGINS.modal.zindex + $(selector+'['+attr+']').length) // Remove previous bound events in globalNamespace .unbind(globalNamespace).unbind(namespace) // Apply our show/hide/focus modal events .bind('tooltipshow'+globalNamespace+' tooltiphide'+globalNamespace, function(event, api, duration) { var oEvent = event.originalEvent; // Make sure mouseout doesn't trigger a hide when showing the modal and mousing onto backdrop if(event.target === tooltip[0]) { if(oEvent && event.type === 'tooltiphide' && /mouse(leave|enter)/.test(oEvent.type) && $(oEvent.relatedTarget).closest(overlay[0]).length) { try { event.preventDefault(); } catch(e) {} } else if(!oEvent || (oEvent && !oEvent.solo)) { self[ event.type.replace('tooltip', '') ](event, duration); } } }) // Adjust modal z-index on tooltip focus .bind('tooltipfocus'+globalNamespace, function(event) { // If focus was cancelled before it reearch us, don't do anything if(event.isDefaultPrevented() || event.target !== tooltip[0]) { return; } var qtips = $(selector).filter('['+attr+']'), // Keep the modal's lower than other, regular qtips newIndex = PLUGINS.modal.zindex + qtips.length, curIndex = parseInt(tooltip[0].style.zIndex, 10); // Set overlay z-index overlay[0].style.zIndex = newIndex - 2; // Reduce modal z-index's and keep them properly ordered qtips.each(function() { if(this.style.zIndex > curIndex) { this.style.zIndex -= 1; } }); // Fire blur event for focused tooltip qtips.end().filter('.' + focusClass).qtip('blur', event.originalEvent); // Set the new z-index tooltip.addClass(focusClass)[0].style.zIndex = newIndex; // Prevent default handling try { event.preventDefault(); } catch(e) {} }) // Focus any other visible modals when this one hides .bind('tooltiphide'+globalNamespace, function(event) { if(event.target === tooltip[0]) { $('[' + attr + ']').filter(':visible').not(tooltip).last().qtip('focus', event); } }); // Apply keyboard "Escape key" close handler if(options.escape) { $(document).unbind(namespace).bind('keydown'+namespace, function(event) { if(event.keyCode === 27 && tooltip.hasClass(focusClass)) { api.hide(event); } }); } // Apply click handler for blur option if(options.blur) { elems.overlay.unbind(namespace).bind('click'+namespace, function(event) { if(tooltip.hasClass(focusClass)) { api.hide(event); } }); } // Update focusable elements updateFocusable(); return self; }, create: function() { var elem = $(overlaySelector); // Return if overlay is already rendered if(elem.length) { // Modal overlay should always be below all tooltips if possible return (elems.overlay = elem.insertAfter( $(selector).last() )); } // Create document overlay overlay = elems.overlay = $('
', { id: overlaySelector.substr(1), html: '
', mousedown: function() { return FALSE; } }) .hide() .insertAfter( $(selector).last() ); // Update position on window resize or scroll function resize() { overlay.css({ height: $(window).height(), width: $(window).width() }); } $(window).unbind(globalNamespace).bind('resize'+globalNamespace, resize); resize(); // Fire it initially too return overlay; }, toggle: function(event, state, duration) { // Make sure default event hasn't been prevented if(event && event.isDefaultPrevented()) { return self; } var effect = options.effect, type = state ? 'show': 'hide', visible = overlay.is(':visible'), modals = $('[' + attr + ']').filter(':visible').not(tooltip), zindex; // Create our overlay if it isn't present already if(!overlay) { overlay = self.create(); } // Prevent modal from conflicting with show.solo, and don't hide backdrop is other modals are visible if((overlay.is(':animated') && visible === state) || (!state && modals.length)) { return self; } // State specific... if(state) { // Set position overlay.css({ left: 0, top: 0 }); // Toggle backdrop cursor style on show overlay.toggleClass('blurs', options.blur); // IF the modal can steal the focus if(options.stealfocus !== FALSE) { // Make sure we can't focus anything outside the tooltip docBody.bind('focusin'+namespace, stealFocus); // Blur the current item and focus anything in the modal we an focusInputs( $('body *') ); } } else { // Undelegate focus handler docBody.unbind('focusin'+namespace); } // Stop all animations overlay.stop(TRUE, FALSE); // Use custom function if provided if($.isFunction(effect)) { effect.call(overlay, state); } // If no effect type is supplied, use a simple toggle else if(effect === FALSE) { overlay[ type ](); } // Use basic fade function else { overlay.fadeTo( parseInt(duration, 10) || 90, state ? 1 : 0, function() { if(!state) { $(this).hide(); } }); } // Reset position on hide if(!state) { overlay.queue(function(next) { overlay.css({ left: '', top: '' }); next(); }); } return self; }, show: function(event, duration) { return self.toggle(event, TRUE, duration); }, hide: function(event, duration) { return self.toggle(event, FALSE, duration); }, destroy: function() { var delBlanket = overlay; if(delBlanket) { // Check if any other modal tooltips are present delBlanket = $('[' + attr + ']').not(tooltip).length < 1; // Remove overlay if needed if(delBlanket) { elems.overlay.remove(); $(document).unbind(globalNamespace); } else { elems.overlay.unbind(globalNamespace+api.id); } // Undelegate focus handler docBody.undelegate('*', 'focusin'+namespace); } // Remove bound events return tooltip.removeAttr(attr).unbind(globalNamespace); } }); self.init(); } PLUGINS.modal = function(api) { var self = api.plugins.modal; return 'object' === typeof self ? self : (api.plugins.modal = new Modal(api)); }; // Plugin needs to be initialized on render PLUGINS.modal.initialize = 'render'; // Setup sanitiztion rules PLUGINS.modal.sanitize = function(opts) { if(opts.show) { if(typeof opts.show.modal !== 'object') { opts.show.modal = { on: !!opts.show.modal }; } else if(typeof opts.show.modal.on === 'undefined') { opts.show.modal.on = TRUE; } } }; // Base z-index for all modal tooltips (use qTip core z-index as a base) PLUGINS.modal.zindex = QTIP.zindex + 1000; // Defines the selector used to select all 'focusable' elements within the modal when using the show.modal.stealfocus option. // Selectors initially taken from http://stackoverflow.com/questions/7668525/is-there-a-jquery-selector-to-get-all-elements-that-can-get-focus PLUGINS.modal.focusable = ['a[href]', 'area[href]', 'input', 'select', 'textarea', 'button', 'iframe', 'object', 'embed', '[tabindex]', '[contenteditable]']; // Extend original api defaults $.extend(TRUE, QTIP.defaults, { show: { modal: { on: FALSE, effect: TRUE, blur: TRUE, stealfocus: TRUE, escape: TRUE } } }); PLUGINS.imagemap = function(api, area, corner, adjustMethod) { if(!area.jquery) { area = $(area); } var cache = (api.cache.areas = {}), shape = (area[0].shape || area.attr('shape')).toLowerCase(), coordsString = area[0].coords || area.attr('coords'), baseCoords = coordsString.split(','), coords = [], image = $('img[usemap="#'+area.parent('map').attr('name')+'"]'), imageOffset = image.offset(), result = { width: 0, height: 0, position: { top: 1e10, right: 0, bottom: 0, left: 1e10 } }, i = 0, next = 0, dimensions; // POLY area coordinate calculator // Special thanks to Ed Cradock for helping out with this. // Uses a binary search algorithm to find suitable coordinates. function polyCoordinates(result, coords, corner) { var i = 0, compareX = 1, compareY = 1, realX = 0, realY = 0, newWidth = result.width, newHeight = result.height; // Use a binary search algorithm to locate most suitable coordinate (hopefully) while(newWidth > 0 && newHeight > 0 && compareX > 0 && compareY > 0) { newWidth = Math.floor(newWidth / 2); newHeight = Math.floor(newHeight / 2); if(corner.x === LEFT){ compareX = newWidth; } else if(corner.x === RIGHT){ compareX = result.width - newWidth; } else{ compareX += Math.floor(newWidth / 2); } if(corner.y === TOP){ compareY = newHeight; } else if(corner.y === BOTTOM){ compareY = result.height - newHeight; } else{ compareY += Math.floor(newHeight / 2); } i = coords.length; while(i--) { if(coords.length < 2){ break; } realX = coords[i][0] - result.position.left; realY = coords[i][1] - result.position.top; if((corner.x === LEFT && realX >= compareX) || (corner.x === RIGHT && realX <= compareX) || (corner.x === CENTER && (realX < compareX || realX > (result.width - compareX))) || (corner.y === TOP && realY >= compareY) || (corner.y === BOTTOM && realY <= compareY) || (corner.y === CENTER && (realY < compareY || realY > (result.height - compareY)))) { coords.splice(i, 1); } } } return { left: coords[0][0], top: coords[0][1] }; } // Make sure we account for padding and borders on the image imageOffset.left += Math.ceil((image.outerWidth() - image.width()) / 2); imageOffset.top += Math.ceil((image.outerHeight() - image.height()) / 2); // Parse coordinates into proper array if(shape === 'poly') { i = baseCoords.length; while(i--) { next = [ parseInt(baseCoords[--i], 10), parseInt(baseCoords[i+1], 10) ]; if(next[0] > result.position.right){ result.position.right = next[0]; } if(next[0] < result.position.left){ result.position.left = next[0]; } if(next[1] > result.position.bottom){ result.position.bottom = next[1]; } if(next[1] < result.position.top){ result.position.top = next[1]; } coords.push(next); } } else { i = -1; while(i++ < baseCoords.length) { coords.push( parseInt(baseCoords[i], 10) ); } } // Calculate details switch(shape) { case 'rect': result = { width: Math.abs(coords[2] - coords[0]), height: Math.abs(coords[3] - coords[1]), position: { left: Math.min(coords[0], coords[2]), top: Math.min(coords[1], coords[3]) } }; break; case 'circle': result = { width: coords[2] + 2, height: coords[2] + 2, position: { left: coords[0], top: coords[1] } }; break; case 'poly': result.width = Math.abs(result.position.right - result.position.left); result.height = Math.abs(result.position.bottom - result.position.top) if(corner.abbrev() === 'c') { result.position = { left: result.position.left + (result.width / 2), top: result.position.top + (result.height / 2) }; } else { // Calculate if we can't find a cached value if(!cache[corner+coordsString]) { result.position = polyCoordinates(result, coords.slice(), corner); // If flip adjustment is enabled, also calculate the closest opposite point if(adjustMethod && (adjustMethod[0] === 'flip' || adjustMethod[1] === 'flip')) { result.offset = polyCoordinates(result, coords.slice(), { x: corner.x === LEFT ? RIGHT : corner.x === RIGHT ? LEFT : CENTER, y: corner.y === TOP ? BOTTOM : corner.y === BOTTOM ? TOP : CENTER }); result.offset.left -= result.position.left; result.offset.top -= result.position.top; } // Store the result cache[corner+coordsString] = result; } // Grab the cached result result = cache[corner+coordsString]; } result.width = result.height = 0; break; } // Add image position to offset coordinates result.position.left += imageOffset.left; result.position.top += imageOffset.top; return result; }; // Tip coordinates calculator function calculateTip(corner, width, height) { var width2 = Math.ceil(width / 2), height2 = Math.ceil(height / 2), // Define tip coordinates in terms of height and width values tips = { bottomright: [[0,0], [width,height], [width,0]], bottomleft: [[0,0], [width,0], [0,height]], topright: [[0,height], [width,0], [width,height]], topleft: [[0,0], [0,height], [width,height]], topcenter: [[0,height], [width2,0], [width,height]], bottomcenter: [[0,0], [width,0], [width2,height]], rightcenter: [[0,0], [width,height2], [0,height]], leftcenter: [[width,0], [width,height], [0,height2]] }; // Set common side shapes tips.lefttop = tips.bottomright; tips.righttop = tips.bottomleft; tips.leftbottom = tips.topright; tips.rightbottom = tips.topleft; return tips[ corner.string() ]; } function Tip(qTip, command) { var self = this, opts = qTip.options.style.tip, elems = qTip.elements, tooltip = elems.tooltip, cache = { top: 0, left: 0 }, size = { width: opts.width, height: opts.height }, color = { }, border = opts.border || 0, namespace = '.qtip-tip', hasCanvas = !!($('')[0] || {}).getContext; self.corner = NULL; self.mimic = NULL; self.border = border; self.offset = opts.offset; self.size = size; // Add new option checks for the plugin qTip.checks.tip = { '^position.my|style.tip.(corner|mimic|border)$': function() { // Make sure a tip can be drawn if(!self.init()) { self.destroy(); } // Reposition the tooltip qTip.reposition(); }, '^style.tip.(height|width)$': function() { // Re-set dimensions and redraw the tip size = { width: opts.width, height: opts.height }; self.create(); self.update(); // Reposition the tooltip qTip.reposition(); }, '^content.title.text|style.(classes|widget)$': function() { if(elems.tip && elems.tip.length) { self.update(); } } }; function swapDimensions() { size.width = opts.height; size.height = opts.width; } function resetDimensions() { size.width = opts.width; size.height = opts.height; } function reposition(event, api, pos, viewport) { if(!elems.tip) { return; } var newCorner = self.corner.clone(), adjust = pos.adjusted, method = qTip.options.position.adjust.method.split(' '), horizontal = method[0], vertical = method[1] || method[0], shift = { left: FALSE, top: FALSE, x: 0, y: 0 }, offset, css = {}, props; // If our tip position isn't fixed e.g. doesn't adjust with viewport... if(self.corner.fixed !== TRUE) { // Horizontal - Shift or flip method if(horizontal === SHIFT && newCorner.precedance === X && adjust.left && newCorner.y !== CENTER) { newCorner.precedance = newCorner.precedance === X ? Y : X; } else if(horizontal !== SHIFT && adjust.left){ newCorner.x = newCorner.x === CENTER ? (adjust.left > 0 ? LEFT : RIGHT) : (newCorner.x === LEFT ? RIGHT : LEFT); } // Vertical - Shift or flip method if(vertical === SHIFT && newCorner.precedance === Y && adjust.top && newCorner.x !== CENTER) { newCorner.precedance = newCorner.precedance === Y ? X : Y; } else if(vertical !== SHIFT && adjust.top) { newCorner.y = newCorner.y === CENTER ? (adjust.top > 0 ? TOP : BOTTOM) : (newCorner.y === TOP ? BOTTOM : TOP); } // Update and redraw the tip if needed (check cached details of last drawn tip) if(newCorner.string() !== cache.corner.string() && (cache.top !== adjust.top || cache.left !== adjust.left)) { self.update(newCorner, FALSE); } } // Setup tip offset properties offset = self.position(newCorner, adjust); offset[ newCorner.x ] += borderWidth(newCorner, newCorner.x, TRUE); offset[ newCorner.y ] += borderWidth(newCorner, newCorner.y, TRUE); // Readjust offset object to make it left/top if(offset.right !== undefined) { offset.left = -offset.right; } if(offset.bottom !== undefined) { offset.top = -offset.bottom; } offset.user = Math.max(0, opts.offset); // Viewport "shift" specific adjustments if(shift.left = (horizontal === SHIFT && !!adjust.left)) { if(newCorner.x === CENTER) { css['margin-left'] = shift.x = offset['margin-left'] - adjust.left; } else { props = offset.right !== undefined ? [ adjust.left, -offset.left ] : [ -adjust.left, offset.left ]; if( (shift.x = Math.max(props[0], props[1])) > props[0] ) { pos.left -= adjust.left; shift.left = FALSE; } css[ offset.right !== undefined ? RIGHT : LEFT ] = shift.x; } } if(shift.top = (vertical === SHIFT && !!adjust.top)) { if(newCorner.y === CENTER) { css['margin-top'] = shift.y = offset['margin-top'] - adjust.top; } else { props = offset.bottom !== undefined ? [ adjust.top, -offset.top ] : [ -adjust.top, offset.top ]; if( (shift.y = Math.max(props[0], props[1])) > props[0] ) { pos.top -= adjust.top; shift.top = FALSE; } css[ offset.bottom !== undefined ? BOTTOM : TOP ] = shift.y; } } /* * If the tip is adjusted in both dimensions, or in a * direction that would cause it to be anywhere but the * outer border, hide it! */ elems.tip.css(css).toggle( !((shift.x && shift.y) || (newCorner.x === CENTER && shift.y) || (newCorner.y === CENTER && shift.x)) ); // Adjust position to accomodate tip dimensions pos.left -= offset.left.charAt ? offset.user : horizontal !== SHIFT || shift.top || !shift.left && !shift.top ? offset.left : 0; pos.top -= offset.top.charAt ? offset.user : vertical !== SHIFT || shift.left || !shift.left && !shift.top ? offset.top : 0; // Cache details cache.left = adjust.left; cache.top = adjust.top; cache.corner = newCorner.clone(); } /* border width calculator */ function borderWidth(corner, side, backup) { side = !side ? corner[corner.precedance] : side; var isFluid = tooltip.hasClass(fluidClass), isTitleTop = elems.titlebar && corner.y === TOP, elem = isTitleTop ? elems.titlebar : elems.tooltip, css = 'border-' + side + '-width', val; // Grab the border-width value (add fluid class if needed) tooltip.addClass(fluidClass); val = parseInt(elem.css(css), 10); val = (backup ? val || parseInt(tooltip.css(css), 10) : val) || 0; tooltip.toggleClass(fluidClass, isFluid); return val; } function borderRadius(corner) { var isTitleTop = elems.titlebar && corner.y === TOP, elem = isTitleTop ? elems.titlebar : elems.content, moz = $.browser.mozilla, prefix = moz ? '-moz-' : $.browser.webkit ? '-webkit-' : '', side = corner.y + (moz ? '' : '-') + corner.x, css = prefix + (moz ? 'border-radius-' + side : 'border-' + side + '-radius'); return parseInt(elem.css(css), 10) || parseInt(tooltip.css(css), 10) || 0; } function calculateSize(corner) { var y = corner.precedance === Y, width = size [ y ? WIDTH : HEIGHT ], height = size [ y ? HEIGHT : WIDTH ], isCenter = corner.string().indexOf(CENTER) > -1, base = width * (isCenter ? 0.5 : 1), pow = Math.pow, round = Math.round, bigHyp, ratio, result, smallHyp = Math.sqrt( pow(base, 2) + pow(height, 2) ), hyp = [ (border / base) * smallHyp, (border / height) * smallHyp ]; hyp[2] = Math.sqrt( pow(hyp[0], 2) - pow(border, 2) ); hyp[3] = Math.sqrt( pow(hyp[1], 2) - pow(border, 2) ); bigHyp = smallHyp + hyp[2] + hyp[3] + (isCenter ? 0 : hyp[0]); ratio = bigHyp / smallHyp; result = [ round(ratio * height), round(ratio * width) ]; return { height: result[ y ? 0 : 1 ], width: result[ y ? 1 : 0 ] }; } $.extend(self, { init: function() { var enabled = self.detectCorner() && (hasCanvas || $.browser.msie); // Determine tip corner and type if(enabled) { // Create a new tip and draw it self.create(); self.update(); // Bind update events tooltip.unbind(namespace).bind('tooltipmove'+namespace, reposition); } return enabled; }, detectCorner: function() { var corner = opts.corner, posOptions = qTip.options.position, at = posOptions.at, my = posOptions.my.string ? posOptions.my.string() : posOptions.my; // Detect corner and mimic properties if(corner === FALSE || (my === FALSE && at === FALSE)) { return FALSE; } else { if(corner === TRUE) { self.corner = new PLUGINS.Corner(my); } else if(!corner.string) { self.corner = new PLUGINS.Corner(corner); self.corner.fixed = TRUE; } } // Cache it cache.corner = new PLUGINS.Corner( self.corner.string() ); return self.corner.string() !== 'centercenter'; }, detectColours: function(actual) { var i, fill, border, tip = elems.tip.css('cssText', ''), corner = actual || self.corner, precedance = corner[ corner.precedance ], borderSide = 'border-' + precedance + '-color', borderSideCamel = 'border' + precedance.charAt(0) + precedance.substr(1) + 'Color', invalid = /rgba?\(0, 0, 0(, 0)?\)|transparent|#123456/i, backgroundColor = 'background-color', transparent = 'transparent', important = ' !important', useTitle = elems.titlebar && (corner.y === TOP || (corner.y === CENTER && tip.position().top + (size.height / 2) + opts.offset < elems.titlebar.outerHeight(1))), colorElem = useTitle ? elems.titlebar : elems.tooltip; // Apply the fluid class so we can see our CSS values properly tooltip.addClass(fluidClass); // Detect tip colours from CSS styles color.fill = fill = tip.css(backgroundColor); color.border = border = tip[0].style[ borderSideCamel ] || tip.css(borderSide) || tooltip.css(borderSide); // Make sure colours are valid if(!fill || invalid.test(fill)) { color.fill = colorElem.css(backgroundColor) || transparent; if(invalid.test(color.fill)) { color.fill = tooltip.css(backgroundColor) || fill; } } if(!border || invalid.test(border) || border === $(document.body).css('color')) { color.border = colorElem.css(borderSide) || transparent; if(invalid.test(color.border) || color.border === colorElem.css('color')) { color.border = tooltip.css(borderSide) || tooltip.css(borderSideCamel) || border; } } // Reset background and border colours $('*', tip).add(tip).css('cssText', backgroundColor+':'+transparent+important+';border:0'+important+';'); // Remove fluid class tooltip.removeClass(fluidClass); }, create: function() { var width = size.width, height = size.height, vml; // Remove previous tip element if present if(elems.tip) { elems.tip.remove(); } // Create tip element and prepend to the tooltip elems.tip = $('
', { 'class': 'ui-tooltip-tip' }).css({ width: width, height: height }).prependTo(tooltip); // Create tip drawing element(s) if(hasCanvas) { // save() as soon as we create the canvas element so FF2 doesn't bork on our first restore()! $('').appendTo(elems.tip)[0].getContext('2d').save(); } else { vml = ''; elems.tip.html(vml + vml); // Prevent mousing down on the tip since it causes problems with .live() handling in IE due to VML $('*', elems.tip).bind('click mousedown', function(event) { event.stopPropagation(); }); } }, update: function(corner, position) { var tip = elems.tip, inner = tip.children(), width = size.width, height = size.height, regular = 'px solid ', transparent = 'px dashed transparent', // Dashed IE6 border-transparency hack. Awesome! mimic = opts.mimic, round = Math.round, precedance, context, coords, translate, newSize; // Re-determine tip if not already set if(!corner) { corner = cache.corner || self.corner; } // Use corner property if we detect an invalid mimic value if(mimic === FALSE) { mimic = corner; } // Otherwise inherit mimic properties from the corner object as necessary else { mimic = new PLUGINS.Corner(mimic); mimic.precedance = corner.precedance; if(mimic.x === 'inherit') { mimic.x = corner.x; } else if(mimic.y === 'inherit') { mimic.y = corner.y; } else if(mimic.x === mimic.y) { mimic[ corner.precedance ] = corner[ corner.precedance ]; } } precedance = mimic.precedance; // Ensure the tip width.height are relative to the tip position if(corner.precedance === X) { swapDimensions(); } else { resetDimensions(); } // Set the tip dimensions elems.tip.css({ width: (width = size.width), height: (height = size.height) }); // Update our colours self.detectColours(corner); // Detect border width, taking into account colours if(color.border !== 'transparent') { // Grab border width border = borderWidth(corner, NULL, TRUE); // If border width isn't zero, use border color as fill (1.0 style tips) if(opts.border === 0 && border > 0) { color.fill = color.border; } // Set border width (use detected border width if opts.border is true) self.border = border = opts.border !== TRUE ? opts.border : border; } // Border colour was invalid, set border to zero else { self.border = border = 0; } // Calculate coordinates coords = calculateTip(mimic, width , height); // Determine tip size self.size = newSize = calculateSize(corner); tip.css(newSize); // Calculate tip translation if(corner.precedance === Y) { translate = [ round(mimic.x === LEFT ? border : mimic.x === RIGHT ? newSize.width - width - border : (newSize.width - width) / 2), round(mimic.y === TOP ? newSize.height - height : 0) ]; } else { translate = [ round(mimic.x === LEFT ? newSize.width - width : 0), round(mimic.y === TOP ? border : mimic.y === BOTTOM ? newSize.height - height - border : (newSize.height - height) / 2) ]; } // Canvas drawing implementation if(hasCanvas) { // Set the canvas size using calculated size inner.attr(newSize); // Grab canvas context and clear/save it context = inner[0].getContext('2d'); context.restore(); context.save(); context.clearRect(0,0,3000,3000); // Set properties context.fillStyle = color.fill; context.strokeStyle = color.border; context.lineWidth = border * 2; context.lineJoin = 'miter'; context.miterLimit = 100; // Translate origin context.translate(translate[0], translate[1]); // Draw the tip context.beginPath(); context.moveTo(coords[0][0], coords[0][1]); context.lineTo(coords[1][0], coords[1][1]); context.lineTo(coords[2][0], coords[2][1]); context.closePath(); // Apply fill and border if(border) { // Make sure transparent borders are supported by doing a stroke // of the background colour before the stroke colour if(tooltip.css('background-clip') === 'border-box') { context.strokeStyle = color.fill; context.stroke(); } context.strokeStyle = color.border; context.stroke(); } context.fill(); } // VML (IE Proprietary implementation) else { // Setup coordinates string coords = 'm' + coords[0][0] + ',' + coords[0][1] + ' l' + coords[1][0] + ',' + coords[1][1] + ' ' + coords[2][0] + ',' + coords[2][1] + ' xe'; // Setup VML-specific offset for pixel-perfection translate[2] = border && /^(r|b)/i.test(corner.string()) ? parseFloat($.browser.version, 10) === 8 ? 2 : 1 : 0; // Set initial CSS inner.css({ antialias: ''+(mimic.string().indexOf(CENTER) > -1), left: translate[0] - (translate[2] * Number(precedance === X)), top: translate[1] - (translate[2] * Number(precedance === Y)), width: width + border, height: height + border }) .each(function(i) { var $this = $(this); // Set shape specific attributes $this[ $this.prop ? 'prop' : 'attr' ]({ coordsize: (width+border) + ' ' + (height+border), path: coords, fillcolor: color.fill, filled: !!i, stroked: !i }) .css({ display: border || i ? 'block' : 'none' }); // Check if border is enabled and add stroke element if(!i && $this.html() === '') { $this.html( '' ); } }); } // Position if needed if(position !== FALSE) { self.position(corner); } }, // Tip positioning method position: function(corner) { var tip = elems.tip, position = {}, userOffset = Math.max(0, opts.offset), precedance, dimensions, corners; // Return if tips are disabled or tip is not yet rendered if(opts.corner === FALSE || !tip) { return FALSE; } // Inherit corner if not provided corner = corner || self.corner; precedance = corner.precedance; // Determine which tip dimension to use for adjustment dimensions = calculateSize(corner); // Setup corners and offset array corners = [ corner.x, corner.y ]; if(precedance === X) { corners.reverse(); } // Calculate tip position $.each(corners, function(i, side) { var b, br; if(side === CENTER) { b = precedance === Y ? LEFT : TOP; position[ b ] = '50%'; position['margin-' + b] = -Math.round(dimensions[ precedance === Y ? WIDTH : HEIGHT ] / 2) + userOffset; } else { b = borderWidth(corner, side); br = borderRadius(corner); position[ side ] = i ? 0 : (userOffset + (br > b ? br : -b)); } }); // Adjust for tip dimensions position[ corner[precedance] ] -= dimensions[ precedance === X ? WIDTH : HEIGHT ]; // Set and return new position tip.css({ top: '', bottom: '', left: '', right: '', margin: '' }).css(position); return position; }, destroy: function() { // Remove the tip element if(elems.tip) { elems.tip.remove(); } elems.tip = false; // Unbind events tooltip.unbind(namespace); } }); self.init(); } PLUGINS.tip = function(api) { var self = api.plugins.tip; return 'object' === typeof self ? self : (api.plugins.tip = new Tip(api)); }; // Initialize tip on render PLUGINS.tip.initialize = 'render'; // Setup plugin sanitization options PLUGINS.tip.sanitize = function(options) { var style = options.style, opts; if(style && 'tip' in style) { opts = options.style.tip; if(typeof opts !== 'object'){ options.style.tip = { corner: opts }; } if(!(/string|boolean/i).test(typeof opts.corner)) { opts.corner = TRUE; } if(typeof opts.width !== 'number'){ delete opts.width; } if(typeof opts.height !== 'number'){ delete opts.height; } if(typeof opts.border !== 'number' && opts.border !== TRUE){ delete opts.border; } if(typeof opts.offset !== 'number'){ delete opts.offset; } } }; // Extend original qTip defaults $.extend(TRUE, QTIP.defaults, { style: { tip: { corner: TRUE, mimic: FALSE, width: 6, height: 6, border: TRUE, offset: 0 } } }); PLUGINS.svg = function(api, svg, corner, adjustMethod) { var doc = $(document), elem = svg[0], result = { width: 0, height: 0, position: { top: 1e10, left: 1e10 } }, box, mtx, root, point, tPoint; // Ascend the parentNode chain until we find an element with getBBox() while(!elem.getBBox) { elem = elem.parentNode; } // Check for a valid bounding box method if (elem.getBBox && elem.parentNode) { box = elem.getBBox(); mtx = elem.getScreenCTM(); root = elem.farthestViewportElement || elem; // Return if no method is found if(!root.createSVGPoint) { return result; } // Create our point var point = root.createSVGPoint(); // Adjust top and left point.x = box.x; point.y = box.y; tPoint = point.matrixTransform(mtx); result.position.left = tPoint.x; result.position.top = tPoint.y; // Adjust width and height point.x += box.width; point.y += box.height; tPoint = point.matrixTransform(mtx); result.width = tPoint.x - result.position.left; result.height = tPoint.y - result.position.top; // Adjust by scroll offset result.position.left += doc.scrollLeft(); result.position.top += doc.scrollTop(); } return result; }; /* * BGIFrame adaption (http://plugins.jquery.com/project/bgiframe) * Special thanks to Brandon Aaron */ function BGIFrame(api) { var self = this, elems = api.elements, tooltip = elems.tooltip, namespace = '.bgiframe-' + api.id; $.extend(self, { init: function() { // Create the BGIFrame element elems.bgiframe = $(''); // Append the new element to the tooltip elems.bgiframe.appendTo(tooltip); // Update BGIFrame on tooltip move tooltip.bind('tooltipmove'+namespace, self.adjust); }, adjust: function() { var dimensions = api.get('dimensions'), // Determine current tooltip dimensions plugin = api.plugins.tip, tip = elems.tip, tipAdjust, offset; // Adjust border offset offset = parseInt(tooltip.css('border-left-width'), 10) || 0; offset = { left: -offset, top: -offset }; // Adjust for tips plugin if(plugin && tip) { tipAdjust = (plugin.corner.precedance === 'x') ? ['width', 'left'] : ['height', 'top']; offset[ tipAdjust[1] ] -= tip[ tipAdjust[0] ](); } // Update bgiframe elems.bgiframe.css(offset).css(dimensions); }, destroy: function() { // Remove iframe elems.bgiframe.remove(); // Remove bound events tooltip.unbind(namespace); } }); self.init(); } PLUGINS.bgiframe = function(api) { var browser = $.browser, self = api.plugins.bgiframe; // Proceed only if the browser is IE6 and offending elements are present if($('select, object').length < 1 || !(browser.msie && (''+browser.version).charAt(0) === '6')) { return FALSE; } return 'object' === typeof self ? self : (api.plugins.bgiframe = new BGIFrame(api)); }; // Plugin needs to be initialized on render PLUGINS.bgiframe.initialize = 'render'; }));