1 /*!

     2  * jquery.qtip. The jQuery tooltip plugin

     3  *

     4  * Copyright (c) 2009 Craig Thompson

     5  * http://craigsworks.com

     6  *

     7  * Licensed under MIT

     8  * http://www.opensource.org/licenses/mit-license.php

     9  *

    10  * Launch  : February 2009

    11  * Version : 1.0.0-rc3

    12  * Released: Tuesday 12th May, 2009 - 00:00

    13  * Debug: jquery.qtip.debug.js

    14  */

    15 (function($)

    16 {

    17    // Implementation

    18    $.fn.qtip = function(options, blanket)

    19    {

    20       var i, id, interfaces, opts, obj, command, config, api;

    21 

    22       // Return API / Interfaces if requested

    23       if(typeof options == 'string')

    24       {

    25          // Make sure API data exists if requested

    26          if(typeof $(this).data('qtip') !== 'object')

    27             $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.NO_TOOLTIP_PRESENT, false);

    28 

    29          // Return requested object

    30          if(options == 'api')

    31             return $(this).data('qtip').interfaces[ $(this).data('qtip').current ];

    32          else if(options == 'interfaces')

    33             return $(this).data('qtip').interfaces;

    34       }

    35 

    36       // Validate provided options

    37       else

    38       {

    39          // Set null options object if no options are provided

    40          if(!options) options = {};

    41 

    42          // Sanitize option data

    43          if(typeof options.content !== 'object' || (options.content.jquery && options.content.length > 0)) options.content = { text: options.content };

    44          if(typeof options.content.title !== 'object') options.content.title = { text: options.content.title };

    45          if(typeof options.position !== 'object') options.position = { corner: options.position };

    46          if(typeof options.position.corner !== 'object') options.position.corner = { target: options.position.corner, tooltip: options.position.corner };

    47          if(typeof options.show !== 'object') options.show = { when: options.show };

    48          if(typeof options.show.when !== 'object') options.show.when = { event: options.show.when };

    49          if(typeof options.show.effect !== 'object') options.show.effect = { type: options.show.effect };

    50          if(typeof options.hide !== 'object') options.hide = { when: options.hide };

    51          if(typeof options.hide.when !== 'object') options.hide.when = { event: options.hide.when };

    52          if(typeof options.hide.effect !== 'object') options.hide.effect = { type: options.hide.effect };

    53          if(typeof options.style !== 'object') options.style = { name: options.style };

    54          options.style = sanitizeStyle(options.style);

    55 

    56          // Build main options object

    57          opts = $.extend(true, {}, $.fn.qtip.defaults, options);

    58 

    59          // Inherit all style properties into one syle object and include original options

    60          opts.style = buildStyle.call({ options: opts }, opts.style);

    61          opts.user = $.extend(true, {}, options);

    62       };

    63 

    64       // Iterate each matched element

    65       return $(this).each(function() // Return original elements as per jQuery guidelines

    66       {

    67          // Check for API commands

    68          if(typeof options == 'string')

    69          {

    70             command = options.toLowerCase();

    71             interfaces = $(this).qtip('interfaces');

    72 

    73             // Make sure API data exists$('.qtip').qtip('destroy')

    74             if(typeof interfaces == 'object')

    75             {

    76                // Check if API call is a BLANKET DESTROY command

    77                if(blanket === true && command == 'destroy')

    78                   while(interfaces.length > 0) interfaces[interfaces.length-1].destroy();

    79 

    80                // API call is not a BLANKET DESTROY command

    81                else

    82                {

    83                   // Check if supplied command effects this tooltip only (NOT BLANKET)

    84                   if(blanket !== true) interfaces = [ $(this).qtip('api') ];

    85 

    86                   // Execute command on chosen qTips

    87                   for(i = 0; i < interfaces.length; i++)

    88                   {

    89                      // Destroy command doesn't require tooltip to be rendered

    90                      if(command == 'destroy') interfaces[i].destroy();

    91 

    92                      // Only call API if tooltip is rendered and it wasn't a destroy call

    93                      else if(interfaces[i].status.rendered === true)

    94                      {

    95                         if(command == 'show') interfaces[i].show();

    96                         else if(command == 'hide') interfaces[i].hide();

    97                         else if(command == 'focus') interfaces[i].focus();

    98                         else if(command == 'disable') interfaces[i].disable(true);

    99                         else if(command == 'enable') interfaces[i].disable(false);

   100                      };

   101                   };

   102                };

   103             };

   104          }

   105 

   106          // No API commands, continue with qTip creation

   107          else

   108          {

   109             // Create unique configuration object

   110             config = $.extend(true, {}, opts);

   111             config.hide.effect.length = opts.hide.effect.length;

   112             config.show.effect.length = opts.show.effect.length;

   113 

   114             // Sanitize target options

   115             if(config.position.container === false) config.position.container = $(document.body);

   116             if(config.position.target === false) config.position.target = $(this);

   117             if(config.show.when.target === false) config.show.when.target = $(this);

   118             if(config.hide.when.target === false) config.hide.when.target = $(this);

   119 

   120             // Determine tooltip ID (Reuse array slots if possible)

   121             id = $.fn.qtip.interfaces.length;

   122             for(i = 0; i < id; i++)

   123             {

   124                if(typeof $.fn.qtip.interfaces[i] == 'undefined'){ id = i; break; };

   125             };

   126 

   127             // Instantiate the tooltip

   128             obj = new qTip($(this), config, id);

   129 

   130             // Add API references

   131             $.fn.qtip.interfaces[id] = obj;

   132 

   133             // Check if element already has qTip data assigned

   134             if(typeof $(this).data('qtip') == 'object')

   135             {

   136                // Set new current interface id

   137                if(typeof $(this).attr('qtip') === 'undefined')

   138                   $(this).data('qtip').current = $(this).data('qtip').interfaces.length;

   139 

   140                // Push new API interface onto interfaces array

   141                $(this).data('qtip').interfaces.push(obj);

   142             }

   143 

   144             // No qTip data is present, create now

   145             else $(this).data('qtip', { current: 0, interfaces: [obj] });

   146 

   147             // If prerendering is disabled, create tooltip on showEvent

   148             if(config.content.prerender === false && config.show.when.event !== false && config.show.ready !== true)

   149             {

   150                config.show.when.target.bind(config.show.when.event+'.qtip-'+id+'-create', { qtip: id }, function(event)

   151                {

   152                   // Retrieve API interface via passed qTip Id

   153                   api = $.fn.qtip.interfaces[ event.data.qtip ];

   154 

   155                   // Unbind show event and cache mouse coords

   156                   api.options.show.when.target.unbind(api.options.show.when.event+'.qtip-'+event.data.qtip+'-create');

   157                   api.cache.mouse = { x: event.pageX, y: event.pageY };

   158 

   159                   // Render tooltip and start the event sequence

   160                   construct.call( api );

   161                   api.options.show.when.target.trigger(api.options.show.when.event);

   162                });

   163             }

   164 

   165             // Prerendering is enabled, create tooltip now

   166             else

   167             {

   168                // Set mouse position cache to top left of the element

   169                obj.cache.mouse = {

   170                   x: config.show.when.target.offset().left,

   171                   y: config.show.when.target.offset().top

   172                };

   173 

   174                // Construct the tooltip

   175                construct.call(obj);

   176             }

   177          };

   178       });

   179    };

   180 

   181    // Instantiator

   182    function qTip(target, options, id)

   183    {

   184       // Declare this reference

   185       var self = this;

   186 

   187       // Setup class attributes

   188       self.id = id;

   189       self.options = options;

   190       self.status = {

   191          animated: false,

   192          rendered: false,

   193          disabled: false,

   194          focused: false

   195       };

   196       self.elements = {

   197          target: target.addClass(self.options.style.classes.target),

   198          tooltip: null,

   199          wrapper: null,

   200          content: null,

   201          contentWrapper: null,

   202          title: null,

   203          button: null,

   204          tip: null,

   205          bgiframe: null

   206       };

   207       self.cache = {

   208          mouse: {},

   209          position: {},

   210          toggle: 0

   211       };

   212       self.timers = {};

   213 

   214       // Define exposed API methods

   215       $.extend(self, self.options.api,

   216       {

   217          show: function(event)

   218          {

   219             var returned, solo;

   220 

   221             // Make sure tooltip is rendered and if not, return

   222             if(!self.status.rendered)

   223                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'show');

   224 

   225             // Only continue if element is visible

   226             if(self.elements.tooltip.css('display') !== 'none') return self;

   227 

   228             // Clear animation queue

   229             self.elements.tooltip.stop(true, false);

   230 

   231             // Call API method and if return value is false, halt

   232             returned = self.beforeShow.call(self, event);

   233             if(returned === false) return self;

   234 

   235             // Define afterShow callback method

   236             function afterShow()

   237             {

   238                // Call API method and focus if it isn't static

   239                if(self.options.position.type !== 'static') self.focus();

   240                self.onShow.call(self, event);

   241 

   242                // Prevent antialias from disappearing in IE7 by removing filter attribute

   243                if($.browser.msie) self.elements.tooltip.get(0).style.removeAttribute('filter');

   244             };

   245 

   246             // Maintain toggle functionality if enabled

   247             self.cache.toggle = 1;

   248 

   249             // Update tooltip position if it isn't static

   250             if(self.options.position.type !== 'static')

   251                self.updatePosition(event, (self.options.show.effect.length > 0));

   252 

   253             // Hide other tooltips if tooltip is solo

   254             if(typeof self.options.show.solo == 'object') solo = $(self.options.show.solo);

   255             else if(self.options.show.solo === true) solo = $('div.qtip').not(self.elements.tooltip);

   256             if(solo) solo.each(function(){ if($(this).qtip('api').status.rendered === true) $(this).qtip('api').hide(); });

   257 

   258             // Show tooltip

   259             if(typeof self.options.show.effect.type == 'function')

   260             {

   261                self.options.show.effect.type.call(self.elements.tooltip, self.options.show.effect.length);

   262                self.elements.tooltip.queue(function(){ afterShow(); $(this).dequeue(); });

   263             }

   264             else

   265             {

   266                switch(self.options.show.effect.type.toLowerCase())

   267                {

   268                   case 'fade':

   269                      self.elements.tooltip.fadeIn(self.options.show.effect.length, afterShow);

   270                      break;

   271                   case 'slide':

   272                      self.elements.tooltip.slideDown(self.options.show.effect.length, function()

   273                      {

   274                         afterShow();

   275                         if(self.options.position.type !== 'static') self.updatePosition(event, true);

   276                      });

   277                      break;

   278                   case 'grow':

   279                      self.elements.tooltip.show(self.options.show.effect.length, afterShow);

   280                      break;

   281                   default:

   282                      self.elements.tooltip.show(null, afterShow);

   283                      break;

   284                };

   285 

   286                // Add active class to tooltip

   287                self.elements.tooltip.addClass(self.options.style.classes.active);

   288             };

   289 

   290             // Log event and return

   291             return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_SHOWN, 'show');

   292          },

   293 

   294          hide: function(event)

   295          {

   296             var returned;

   297 

   298             // Make sure tooltip is rendered and if not, return

   299             if(!self.status.rendered)

   300                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'hide');

   301 

   302             // Only continue if element is visible

   303             else if(self.elements.tooltip.css('display') === 'none') return self;

   304 

   305             // Stop show timer and animation queue

   306             clearTimeout(self.timers.show);

   307             self.elements.tooltip.stop(true, false);

   308 

   309             // Call API method and if return value is false, halt

   310             returned = self.beforeHide.call(self, event);

   311             if(returned === false) return self;

   312 

   313             // Define afterHide callback method

   314             function afterHide(){ self.onHide.call(self, event); };

   315 

   316             // Maintain toggle functionality if enabled

   317             self.cache.toggle = 0;

   318 

   319             // Hide tooltip

   320             if(typeof self.options.hide.effect.type == 'function')

   321             {

   322                self.options.hide.effect.type.call(self.elements.tooltip, self.options.hide.effect.length);

   323                self.elements.tooltip.queue(function(){ afterHide(); $(this).dequeue(); });

   324             }

   325             else

   326             {

   327                switch(self.options.hide.effect.type.toLowerCase())

   328                {

   329                   case 'fade':

   330                      self.elements.tooltip.fadeOut(self.options.hide.effect.length, afterHide);

   331                      break;

   332                   case 'slide':

   333                      self.elements.tooltip.slideUp(self.options.hide.effect.length, afterHide);

   334                      break;

   335                   case 'grow':

   336                      self.elements.tooltip.hide(self.options.hide.effect.length, afterHide);

   337                      break;

   338                   default:

   339                      self.elements.tooltip.hide(null, afterHide);

   340                      break;

   341                };

   342 

   343                // Remove active class to tooltip

   344                self.elements.tooltip.removeClass(self.options.style.classes.active);

   345             };

   346 

   347             // Log event and return

   348             return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_HIDDEN, 'hide');

   349          },

   350 

   351          updatePosition: function(event, animate)

   352          {

   353             var i, target, tooltip, coords, mapName, imagePos, newPosition, ieAdjust, ie6Adjust, borderAdjust, mouseAdjust, offset, curPosition, returned

   354 

   355             // Make sure tooltip is rendered and if not, return

   356             if(!self.status.rendered)

   357                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'updatePosition');

   358 

   359             // If tooltip is static, return

   360             else if(self.options.position.type == 'static')

   361                return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.CANNOT_POSITION_STATIC, 'updatePosition');

   362 

   363             // Define property objects

   364             target = {

   365                position: { left: 0, top: 0 },

   366                dimensions: { height: 0, width: 0 },

   367                corner: self.options.position.corner.target

   368             };

   369             tooltip = {

   370                position: self.getPosition(),

   371                dimensions: self.getDimensions(),

   372                corner: self.options.position.corner.tooltip

   373             };

   374 

   375             // Target is an HTML element

   376             if(self.options.position.target !== 'mouse')

   377             {

   378                // If the HTML element is AREA, calculate position manually

   379                if(self.options.position.target.get(0).nodeName.toLowerCase() == 'area')

   380                {

   381                   // Retrieve coordinates from coords attribute and parse into integers

   382                   coords = self.options.position.target.attr('coords').split(',');

   383                   for(i = 0; i < coords.length; i++) coords[i] = parseInt(coords[i]);

   384 

   385                   // Setup target position object

   386                   mapName = self.options.position.target.parent('map').attr('name');

   387                   imagePos = $('img[usemap="#'+mapName+'"]:first').offset();

   388                   target.position = {

   389                      left: Math.floor(imagePos.left + coords[0]),

   390                      top: Math.floor(imagePos.top + coords[1])

   391                   };

   392 

   393                   // Determine width and height of the area

   394                   switch(self.options.position.target.attr('shape').toLowerCase())

   395                   {

   396                      case 'rect':

   397                         target.dimensions = {

   398                            width: Math.ceil(Math.abs(coords[2] - coords[0])),

   399                            height: Math.ceil(Math.abs(coords[3] - coords[1]))

   400                         };

   401                         break;

   402 

   403                      case 'circle':

   404                         target.dimensions = {

   405                            width: coords[2] + 1,

   406                            height: coords[2] + 1

   407                         };

   408                         break;

   409 

   410                      case 'poly':

   411                         target.dimensions = {

   412                            width: coords[0],

   413                            height: coords[1]

   414                         };

   415 

   416                         for(i = 0; i < coords.length; i++)

   417                         {

   418                            if(i % 2 == 0)

   419                            {

   420                               if(coords[i] > target.dimensions.width)

   421                                  target.dimensions.width = coords[i];

   422                               if(coords[i] < coords[0])

   423                                  target.position.left = Math.floor(imagePos.left + coords[i]);

   424                            }

   425                            else

   426                            {

   427                               if(coords[i] > target.dimensions.height)

   428                                  target.dimensions.height = coords[i];

   429                               if(coords[i] < coords[1])

   430                                  target.position.top = Math.floor(imagePos.top + coords[i]);

   431                            };

   432                         };

   433 

   434                         target.dimensions.width = target.dimensions.width - (target.position.left - imagePos.left);

   435                         target.dimensions.height = target.dimensions.height - (target.position.top - imagePos.top);

   436                         break;

   437 

   438                      default:

   439                         return $.fn.qtip.log.error.call(self, 4, $.fn.qtip.constants.INVALID_AREA_SHAPE, 'updatePosition');

   440                         break;

   441                   };

   442 

   443                   // Adjust position by 2 pixels (Positioning bug?)

   444                   target.dimensions.width -= 2; target.dimensions.height -= 2;

   445                }

   446 

   447                // Target is the document

   448                else if(self.options.position.target.add(document.body).length === 1)

   449                {

   450                   target.position = { left: $(document).scrollLeft(), top: $(document).scrollTop() };

   451                   target.dimensions = { height: $(window).height(), width: $(window).width() };

   452                }

   453 

   454                // Target is a regular HTML element, find position normally

   455                else

   456                {

   457                   // Check if the target is another tooltip. If its animated, retrieve position from newPosition data

   458                   if(typeof self.options.position.target.attr('qtip') !== 'undefined')

   459                      target.position = self.options.position.target.qtip('api').cache.position;

   460                   else

   461                      target.position = self.options.position.target.offset();

   462 

   463                   // Setup dimensions objects

   464                   target.dimensions = {

   465                      height: self.options.position.target.outerHeight(),

   466                      width: self.options.position.target.outerWidth()

   467                   };

   468                };

   469 

   470                // Calculate correct target corner position

   471                newPosition = $.extend({}, target.position);

   472                if(target.corner.search(/right/i) !== -1)

   473                   newPosition.left += target.dimensions.width;

   474 

   475                if(target.corner.search(/bottom/i) !== -1)

   476                   newPosition.top += target.dimensions.height;

   477 

   478                if(target.corner.search(/((top|bottom)Middle)|center/) !== -1)

   479                   newPosition.left += (target.dimensions.width / 2);

   480 

   481                if(target.corner.search(/((left|right)Middle)|center/) !== -1)

   482                   newPosition.top += (target.dimensions.height / 2);

   483             }

   484 

   485             // Mouse is the target, set position to current mouse coordinates

   486             else

   487             {

   488                // Setup target position and dimensions objects

   489                target.position = newPosition = { left: self.cache.mouse.x, top: self.cache.mouse.y };

   490                target.dimensions = { height: 1, width: 1 };

   491             };

   492 

   493             // Calculate correct target corner position

   494             if(tooltip.corner.search(/right/i) !== -1)

   495                newPosition.left -= tooltip.dimensions.width;

   496 

   497             if(tooltip.corner.search(/bottom/i) !== -1)

   498                newPosition.top -= tooltip.dimensions.height;

   499 

   500             if(tooltip.corner.search(/((top|bottom)Middle)|center/) !== -1)

   501                newPosition.left -= (tooltip.dimensions.width / 2);

   502 

   503             if(tooltip.corner.search(/((left|right)Middle)|center/) !== -1)

   504                newPosition.top -= (tooltip.dimensions.height / 2);

   505 

   506             // Setup IE adjustment variables (Pixel gap bugs)

   507             ieAdjust = ($.browser.msie) ? 1 : 0; // And this is why I hate IE...

   508             ie6Adjust = ($.browser.msie && parseInt($.browser.version.charAt(0)) === 6) ? 1 : 0; // ...and even more so IE6!

   509 

   510             // Adjust for border radius

   511             if(self.options.style.border.radius > 0)

   512             {

   513                if(tooltip.corner.search(/Left/) !== -1)

   514                   newPosition.left -= self.options.style.border.radius;

   515                else if(tooltip.corner.search(/Right/) !== -1)

   516                   newPosition.left += self.options.style.border.radius;

   517 

   518                if(tooltip.corner.search(/Top/) !== -1)

   519                   newPosition.top -= self.options.style.border.radius;

   520                else if(tooltip.corner.search(/Bottom/) !== -1)

   521                   newPosition.top += self.options.style.border.radius;

   522             };

   523 

   524             // IE only adjustments (Pixel perfect!)

   525             if(ieAdjust)

   526             {

   527                if(tooltip.corner.search(/top/) !== -1)

   528                   newPosition.top -= ieAdjust

   529                else if(tooltip.corner.search(/bottom/) !== -1)

   530                   newPosition.top += ieAdjust

   531 

   532                if(tooltip.corner.search(/left/) !== -1)

   533                   newPosition.left -= ieAdjust

   534                else if(tooltip.corner.search(/right/) !== -1)

   535                   newPosition.left += ieAdjust

   536 

   537                if(tooltip.corner.search(/leftMiddle|rightMiddle/) !== -1)

   538                   newPosition.top -= 1

   539             };

   540 

   541             // If screen adjustment is enabled, apply adjustments

   542             if(self.options.position.adjust.screen === true)

   543                newPosition = screenAdjust.call(self, newPosition, target, tooltip);

   544 

   545             // If mouse is the target, prevent tooltip appearing directly under the mouse

   546             if(self.options.position.target === 'mouse' && self.options.position.adjust.mouse === true)

   547             {

   548                if(self.options.position.adjust.screen === true && self.elements.tip)

   549                   mouseAdjust = self.elements.tip.attr('rel');

   550                else

   551                   mouseAdjust = self.options.position.corner.tooltip;

   552 

   553                newPosition.left += (mouseAdjust.search(/right/i) !== -1) ? -6 : 6;

   554                newPosition.top += (mouseAdjust.search(/bottom/i) !== -1) ? -6 : 6;

   555             }

   556 

   557             // Initiate bgiframe plugin in IE6 if tooltip overlaps a select box or object element

   558             if(!self.elements.bgiframe && $.browser.msie && parseInt($.browser.version.charAt(0)) == 6)

   559             {

   560                $('select, object').each(function()

   561                {

   562                   offset = $(this).offset();

   563                   offset.bottom = offset.top + $(this).height();

   564                   offset.right = offset.left + $(this).width();

   565 

   566                   if(newPosition.top + tooltip.dimensions.height >= offset.top

   567                   && newPosition.left + tooltip.dimensions.width >= offset.left)

   568                      bgiframe.call(self);

   569                });

   570             };

   571 

   572             // Add user xy adjustments

   573             newPosition.left += self.options.position.adjust.x;

   574             newPosition.top += self.options.position.adjust.y;

   575 

   576             // Set new tooltip position if its moved, animate if enabled

   577             curPosition = self.getPosition();

   578             if(newPosition.left != curPosition.left || newPosition.top != curPosition.top)

   579             {

   580                // Call API method and if return value is false, halt

   581                returned = self.beforePositionUpdate.call(self, event);

   582                if(returned === false) return self;

   583 

   584                // Cache new position

   585                self.cache.position = newPosition;

   586 

   587                // Check if animation is enabled

   588                if(animate === true)

   589                {

   590                   // Set animated status

   591                   self.status.animated = true;

   592 

   593                   // Animate and reset animated status on animation end

   594                   self.elements.tooltip.animate(newPosition, 200, 'swing', function(){ self.status.animated = false });

   595                }

   596 

   597                // Set new position via CSS

   598                else self.elements.tooltip.css(newPosition);

   599 

   600                // Call API method and log event if its not a mouse move

   601                self.onPositionUpdate.call(self, event);

   602                if(typeof event !== 'undefined' && event.type && event.type !== 'mousemove')

   603                   $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_POSITION_UPDATED, 'updatePosition');

   604             };

   605 

   606             return self;

   607          },

   608 

   609          updateWidth: function(newWidth)

   610          {

   611             var hidden;

   612 

   613             // Make sure tooltip is rendered and if not, return

   614             if(!self.status.rendered)

   615                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'updateWidth');

   616 

   617             // Make sure supplied width is a number and if not, return

   618             else if(newWidth && typeof newWidth !== 'number')

   619                return $.fn.qtip.log.error.call(self, 2, 'newWidth must be of type number', 'updateWidth');

   620 

   621             // Setup elements which must be hidden during width update

   622             hidden = self.elements.contentWrapper.siblings().add(self.elements.tip).add(self.elements.button);

   623 

   624             // Calculate the new width if one is not supplied

   625             if(!newWidth)

   626             {

   627                // Explicit width is set

   628                if(typeof self.options.style.width.value == 'number')

   629                   newWidth = self.options.style.width.value;

   630 

   631                // No width is set, proceed with auto detection

   632                else

   633                {

   634                   // Set width to auto initally to determine new width and hide other elements

   635                   self.elements.tooltip.css({ width: 'auto' });

   636                   hidden.hide();

   637 

   638                   // Set position and zoom to defaults to prevent IE hasLayout bug

   639                   if($.browser.msie)

   640                      self.elements.wrapper.add(self.elements.contentWrapper.children()).css({ zoom: 'normal' });

   641 

   642                   // Set the new width

   643                   newWidth = self.getDimensions().width + 1;

   644 

   645                   // Make sure its within the maximum and minimum width boundries

   646                   if(!self.options.style.width.value)

   647                   {

   648                      if(newWidth > self.options.style.width.max) newWidth = self.options.style.width.max

   649                      if(newWidth < self.options.style.width.min) newWidth = self.options.style.width.min

   650                   };

   651                };

   652             };

   653 

   654             // Adjust newWidth by 1px if width is odd (IE6 rounding bug fix)

   655             if(newWidth % 2 !== 0) newWidth -= 1;

   656 

   657             // Set the new calculated width and unhide other elements

   658             self.elements.tooltip.width(newWidth);

   659             hidden.show();

   660 

   661             // Set the border width, if enabled

   662             if(self.options.style.border.radius)

   663             {

   664                self.elements.tooltip.find('.qtip-betweenCorners').each(function(i)

   665                {

   666                   $(this).width(newWidth - (self.options.style.border.radius * 2));

   667                })

   668             };

   669 

   670             // IE only adjustments

   671             if($.browser.msie)

   672             {

   673                // Reset position and zoom to give the wrapper layout (IE hasLayout bug)

   674                self.elements.wrapper.add(self.elements.contentWrapper.children()).css({ zoom: '1' });

   675 

   676                // Set the new width

   677                self.elements.wrapper.width(newWidth);

   678 

   679                // Adjust BGIframe height and width if enabled

   680                if(self.elements.bgiframe) self.elements.bgiframe.width(newWidth).height(self.getDimensions.height);

   681             };

   682 

   683             // Log event and return

   684             return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_WIDTH_UPDATED, 'updateWidth');

   685          },

   686 

   687          updateStyle: function(name)

   688          {

   689             var tip, borders, context, corner, coordinates;

   690 

   691             // Make sure tooltip is rendered and if not, return

   692             if(!self.status.rendered)

   693                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'updateStyle');

   694 

   695             // Return if style is not defined or name is not a string

   696             else if(typeof name !== 'string' || !$.fn.qtip.styles[name])

   697                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.STYLE_NOT_DEFINED, 'updateStyle');

   698 

   699             // Set the new style object

   700             self.options.style = buildStyle.call(self, $.fn.qtip.styles[name], self.options.user.style);

   701 

   702             // Update initial styles of content and title elements

   703             self.elements.content.css( jQueryStyle(self.options.style) );

   704             if(self.options.content.title.text !== false)

   705                self.elements.title.css( jQueryStyle(self.options.style.title, true) );

   706 

   707             // Update CSS border colour

   708             self.elements.contentWrapper.css({ borderColor: self.options.style.border.color });

   709 

   710             // Update tip color if enabled

   711             if(self.options.style.tip.corner !== false)

   712             {

   713                if($('<canvas>').get(0).getContext)

   714                {

   715                   // Retrieve canvas context and clear

   716                   tip = self.elements.tooltip.find('.qtip-tip canvas:first');

   717                   context = tip.get(0).getContext('2d');

   718                   context.clearRect(0,0,300,300);

   719 

   720                   // Draw new tip

   721                   corner = tip.parent('div[rel]:first').attr('rel');

   722                   coordinates = calculateTip(corner, self.options.style.tip.size.width, self.options.style.tip.size.height);

   723                   drawTip.call(self, tip, coordinates, self.options.style.tip.color || self.options.style.border.color);

   724                }

   725                else if($.browser.msie)

   726                {

   727                   // Set new fillcolor attribute

   728                   tip = self.elements.tooltip.find('.qtip-tip [nodeName="shape"]');

   729                   tip.attr('fillcolor', self.options.style.tip.color || self.options.style.border.color);

   730                };

   731             };

   732 

   733             // Update border colors if enabled

   734             if(self.options.style.border.radius > 0)

   735             {

   736                self.elements.tooltip.find('.qtip-betweenCorners').css({ backgroundColor: self.options.style.border.color });

   737 

   738                if($('<canvas>').get(0).getContext)

   739                {

   740                   borders = calculateBorders(self.options.style.border.radius)

   741                   self.elements.tooltip.find('.qtip-wrapper canvas').each(function()

   742                   {

   743                      // Retrieve canvas context and clear

   744                      context = $(this).get(0).getContext('2d');

   745                      context.clearRect(0,0,300,300);

   746 

   747                      // Draw new border

   748                      corner = $(this).parent('div[rel]:first').attr('rel')

   749                      drawBorder.call(self, $(this), borders[corner],

   750                         self.options.style.border.radius, self.options.style.border.color);

   751                   });

   752                }

   753                else if($.browser.msie)

   754                {

   755                   // Set new fillcolor attribute on each border corner

   756                   self.elements.tooltip.find('.qtip-wrapper [nodeName="arc"]').each(function()

   757                   {

   758                      $(this).attr('fillcolor', self.options.style.border.color)

   759                   });

   760                };

   761             };

   762 

   763             // Log event and return

   764             return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_STYLE_UPDATED, 'updateStyle');

   765          },

   766 

   767          updateContent: function(content, reposition)

   768          {

   769             var parsedContent, images, loadedImages;

   770 

   771             // Make sure tooltip is rendered and if not, return

   772             if(!self.status.rendered)

   773                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'updateContent');

   774 

   775             // Make sure content is defined before update

   776             else if(!content)

   777                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.NO_CONTENT_PROVIDED, 'updateContent');

   778 

   779             // Call API method and set new content if a string is returned

   780             parsedContent = self.beforeContentUpdate.call(self, content);

   781             if(typeof parsedContent == 'string') content = parsedContent;

   782             else if(parsedContent === false) return;

   783 

   784             // Set position and zoom to defaults to prevent IE hasLayout bug

   785             if($.browser.msie) self.elements.contentWrapper.children().css({ zoom: 'normal' });

   786 

   787             // Append new content if its a DOM array and show it if hidden

   788             if(content.jquery && content.length > 0)

   789                content.clone(true).appendTo(self.elements.content).show();

   790 

   791             // Content is a regular string, insert the new content

   792             else self.elements.content.html(content);

   793 

   794             // Check if images need to be loaded before position is updated to prevent mis-positioning

   795             images = self.elements.content.find('img[complete=false]');

   796             if(images.length > 0)

   797             {

   798                loadedImages = 0;

   799                images.each(function(i)

   800                {

   801                   $('<img src="'+ $(this).attr('src') +'" />')

   802                      .load(function(){ if(++loadedImages == images.length) afterLoad(); });

   803                });

   804             }

   805             else afterLoad();

   806 

   807             function afterLoad()

   808             {

   809                // Update the tooltip width

   810                self.updateWidth();

   811 

   812                // If repositioning is enabled, update positions

   813                if(reposition !== false)

   814                {

   815                   // Update position if tooltip isn't static

   816                   if(self.options.position.type !== 'static')

   817                      self.updatePosition(self.elements.tooltip.is(':visible'), true);

   818 

   819                   // Reposition the tip if enabled

   820                   if(self.options.style.tip.corner !== false)

   821                      positionTip.call(self);

   822                };

   823             };

   824 

   825             // Call API method and log event

   826             self.onContentUpdate.call(self);

   827             return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_CONTENT_UPDATED, 'loadContent');

   828          },

   829 

   830          loadContent: function(url, data, method)

   831          {

   832             var returned;

   833 

   834             // Make sure tooltip is rendered and if not, return

   835             if(!self.status.rendered)

   836                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'loadContent');

   837 

   838             // Call API method and if return value is false, halt

   839             returned = self.beforeContentLoad.call(self);

   840             if(returned === false) return self;

   841 

   842             // Load content using specified request type

   843             if(method == 'post')

   844                $.post(url, data, setupContent);

   845             else

   846                $.get(url, data, setupContent);

   847 

   848             function setupContent(content)

   849             {

   850                // Call API method and log event

   851                self.onContentLoad.call(self);

   852                $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_CONTENT_LOADED, 'loadContent');

   853 

   854                // Update the content

   855                self.updateContent(content);

   856             };

   857 

   858             return self;

   859          },

   860 

   861          updateTitle: function(content)

   862          {

   863             // Make sure tooltip is rendered and if not, return

   864             if(!self.status.rendered)

   865                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'updateTitle');

   866 

   867             // Make sure content is defined before update

   868             else if(!content)

   869                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.NO_CONTENT_PROVIDED, 'updateTitle');

   870 

   871             // Call API method and if return value is false, halt

   872             returned = self.beforeTitleUpdate.call(self);

   873             if(returned === false) return self;

   874 

   875             // Set the new content and reappend the button if enabled

   876             if(self.elements.button) self.elements.button = self.elements.button.clone(true);

   877             self.elements.title.html(content)

   878             if(self.elements.button) self.elements.title.prepend(self.elements.button);

   879 

   880             // Call API method and log event

   881             self.onTitleUpdate.call(self);

   882             return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_TITLE_UPDATED, 'updateTitle');

   883          },

   884 

   885          focus: function(event)

   886          {

   887             var curIndex, newIndex, elemIndex, returned;

   888 

   889             // Make sure tooltip is rendered and if not, return

   890             if(!self.status.rendered)

   891                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'focus');

   892 

   893             else if(self.options.position.type == 'static')

   894                return $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.CANNOT_FOCUS_STATIC, 'focus');

   895 

   896             // Set z-index variables

   897             curIndex = parseInt( self.elements.tooltip.css('z-index') );

   898             newIndex = 6000 + $('div.qtip[qtip]').length - 1;

   899 

   900             // Only update the z-index if it has changed and tooltip is not already focused

   901             if(!self.status.focused && curIndex !== newIndex)

   902             {

   903                // Call API method and if return value is false, halt

   904                returned = self.beforeFocus.call(self, event);

   905                if(returned === false) return self;

   906 

   907                // Loop through all other tooltips

   908                $('div.qtip[qtip]').not(self.elements.tooltip).each(function()

   909                {

   910                   if($(this).qtip('api').status.rendered === true)

   911                   {

   912                      elemIndex = parseInt($(this).css('z-index'));

   913 

   914                      // Reduce all other tooltip z-index by 1

   915                      if(typeof elemIndex == 'number' && elemIndex > -1)

   916                         $(this).css({ zIndex: parseInt( $(this).css('z-index') ) - 1 });

   917 

   918                      // Set focused status to false

   919                      $(this).qtip('api').status.focused = false;

   920                   }

   921                })

   922 

   923                // Set the new z-index and set focus status to true

   924                self.elements.tooltip.css({ zIndex: newIndex });

   925                self.status.focused = true;

   926 

   927                // Call API method and log event

   928                self.onFocus.call(self, event);

   929                $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_FOCUSED, 'focus');

   930             };

   931 

   932             return self;

   933          },

   934 

   935          disable: function(state)

   936          {

   937             // Make sure tooltip is rendered and if not, return

   938             if(!self.status.rendered)

   939                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'disable');

   940 

   941             if(state)

   942             {

   943                // Tooltip is not already disabled, proceed

   944                if(!self.status.disabled)

   945                {

   946                   // Set the disabled flag and log event

   947                   self.status.disabled = true;

   948                   $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_DISABLED, 'disable');

   949                }

   950 

   951                // Tooltip is already disabled, inform user via log

   952                else  $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.TOOLTIP_ALREADY_DISABLED, 'disable');

   953             }

   954             else

   955             {

   956                // Tooltip is not already enabled, proceed

   957                if(self.status.disabled)

   958                {

   959                   // Reassign events, set disable status and log

   960                   self.status.disabled = false;

   961                   $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_ENABLED, 'disable');

   962                }

   963 

   964                // Tooltip is already enabled, inform the user via log

   965                else $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.TOOLTIP_ALREADY_ENABLED, 'disable');

   966             };

   967 

   968             return self;

   969          },

   970 

   971          destroy: function()

   972          {

   973             var i, returned, interfaces;

   974 

   975             // Call API method and if return value is false, halt

   976             returned = self.beforeDestroy.call(self);

   977             if(returned === false) return self;

   978 

   979             // Check if tooltip is rendered

   980             if(self.status.rendered)

   981             {

   982                // Remove event handlers and remove element

   983                self.options.show.when.target.unbind('mousemove.qtip', self.updatePosition);

   984                self.options.show.when.target.unbind('mouseout.qtip', self.hide);

   985                self.options.show.when.target.unbind(self.options.show.when.event + '.qtip');

   986                self.options.hide.when.target.unbind(self.options.hide.when.event + '.qtip');

   987                self.elements.tooltip.unbind(self.options.hide.when.event + '.qtip');

   988                self.elements.tooltip.unbind('mouseover.qtip', self.focus);

   989                self.elements.tooltip.remove();

   990             }

   991 

   992             // Tooltip isn't yet rendered, remove render event

   993             else self.options.show.when.target.unbind(self.options.show.when.event+'.qtip-create');

   994 

   995             // Check to make sure qTip data is present on target element

   996             if(typeof self.elements.target.data('qtip') == 'object')

   997             {

   998                // Remove API references from interfaces object

   999                interfaces = self.elements.target.data('qtip').interfaces;

  1000                if(typeof interfaces == 'object' && interfaces.length > 0)

  1001                {

  1002                   // Remove API from interfaces array

  1003                   for(i = 0; i < interfaces.length - 1; i++)

  1004                      if(interfaces[i].id == self.id) interfaces.splice(i, 1)

  1005                }

  1006             }

  1007             delete $.fn.qtip.interfaces[self.id];

  1008 

  1009             // Set qTip current id to previous tooltips API if available

  1010             if(typeof interfaces == 'object' && interfaces.length > 0)

  1011                self.elements.target.data('qtip').current = interfaces.length -1;

  1012             else

  1013                self.elements.target.removeData('qtip');

  1014 

  1015             // Call API method and log destroy

  1016             self.onDestroy.call(self);

  1017             $.fn.qtip.log.error.call(self, 1, $.fn.qtip.constants.EVENT_DESTROYED, 'destroy');

  1018 

  1019             return self.elements.target

  1020          },

  1021 

  1022          getPosition: function()

  1023          {

  1024             var show, offset;

  1025 

  1026             // Make sure tooltip is rendered and if not, return

  1027             if(!self.status.rendered)

  1028                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'getPosition');

  1029 

  1030             show = (self.elements.tooltip.css('display') !== 'none') ? false : true;

  1031 

  1032             // Show and hide tooltip to make sure coordinates are returned

  1033             if(show) self.elements.tooltip.css({ visiblity: 'hidden' }).show();

  1034             offset = self.elements.tooltip.offset();

  1035             if(show) self.elements.tooltip.css({ visiblity: 'visible' }).hide();

  1036 

  1037             return offset;

  1038          },

  1039 

  1040          getDimensions: function()

  1041          {

  1042             var show, dimensions;

  1043 

  1044             // Make sure tooltip is rendered and if not, return

  1045             if(!self.status.rendered)

  1046                return $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.TOOLTIP_NOT_RENDERED, 'getDimensions');

  1047 

  1048             show = (!self.elements.tooltip.is(':visible')) ? true : false;

  1049 

  1050             // Show and hide tooltip to make sure dimensions are returned

  1051             if(show) self.elements.tooltip.css({ visiblity: 'hidden' }).show();

  1052             dimensions = {

  1053                height: self.elements.tooltip.outerHeight(),

  1054                width: self.elements.tooltip.outerWidth()

  1055             };

  1056             if(show) self.elements.tooltip.css({ visiblity: 'visible' }).hide();

  1057 

  1058             return dimensions;

  1059          }

  1060       });

  1061    };

  1062 

  1063    // Define priamry construct function

  1064    function construct()

  1065    {

  1066       var self, adjust, content, url, data, method, tempLength;

  1067       self = this;

  1068 

  1069       // Call API method

  1070       self.beforeRender.call(self);

  1071 

  1072       // Set rendered status to true

  1073       self.status.rendered = true;

  1074 

  1075       // Create initial tooltip elements

  1076       self.elements.tooltip =  '<div qtip="'+self.id+'" ' +

  1077          'class="qtip '+(self.options.style.classes.tooltip || self.options.style)+'"' +

  1078          'style="display:none; -moz-border-radius:0; -webkit-border-radius:0; border-radius:0;' +

  1079          'position:'+self.options.position.type+';">' +

  1080          '  <div class="qtip-wrapper" style="position:relative; overflow:hidden; text-align:left;">' +

  1081          '    <div class="qtip-contentWrapper" style="overflow:hidden;">' +

  1082          '       <div class="qtip-content '+self.options.style.classes.content+'"></div>' +

  1083          '</div></div></div>';

  1084 

  1085       // Append to container element

  1086       self.elements.tooltip = $(self.elements.tooltip);

  1087       self.elements.tooltip.appendTo(self.options.position.container)

  1088 

  1089       // Setup tooltip qTip data

  1090       self.elements.tooltip.data('qtip', { current: 0, interfaces: [self] });

  1091 

  1092       // Setup element references

  1093       self.elements.wrapper = self.elements.tooltip.children('div:first');

  1094       self.elements.contentWrapper = self.elements.wrapper.children('div:first').css({ background: self.options.style.background });

  1095       self.elements.content = self.elements.contentWrapper.children('div:first').css( jQueryStyle(self.options.style) );

  1096 

  1097       // Apply IE hasLayout fix to wrapper and content elements

  1098       if($.browser.msie) self.elements.wrapper.add(self.elements.content).css({ zoom: 1 });

  1099 

  1100       // Setup tooltip attributes

  1101       if(self.options.hide.when.event == 'unfocus') self.elements.tooltip.attr('unfocus', true);

  1102 

  1103       // If an explicit width is set, updateWidth prior to setting content to prevent dirty rendering

  1104       if(typeof self.options.style.width.value == 'number') self.updateWidth();

  1105 

  1106       // Create borders and tips if supported by the browser

  1107       if($('<canvas>').get(0).getContext || $.browser.msie)

  1108       {

  1109          // Create border

  1110          if(self.options.style.border.radius > 0)

  1111             createBorder.call(self);

  1112          else

  1113             self.elements.contentWrapper.css({ border: self.options.style.border.width+'px solid '+self.options.style.border.color  });

  1114 

  1115          // Create tip if enabled

  1116          if(self.options.style.tip.corner !== false)

  1117             createTip.call(self);

  1118       }

  1119 

  1120       // Neither canvas or VML is supported, tips and borders cannot be drawn!

  1121       else

  1122       {

  1123          // Set defined border width

  1124          self.elements.contentWrapper.css({ border: self.options.style.border.width+'px solid '+self.options.style.border.color  });

  1125 

  1126          // Reset border radius and tip

  1127          self.options.style.border.radius = 0;

  1128          self.options.style.tip.corner = false;

  1129 

  1130          // Inform via log

  1131          $.fn.qtip.log.error.call(self, 2, $.fn.qtip.constants.CANVAS_VML_NOT_SUPPORTED, 'render');

  1132       };

  1133 

  1134       // Use the provided content string or DOM array

  1135       if((typeof self.options.content.text == 'string' && self.options.content.text.length > 0)