jQuery PicTip

jQuery PicTip is a plugin that adds handy tooltips to your images, slideshows, sliders and more.

Features

• Easy configuration and customization
• Easy integration with slideshows, sliders, 360 views, and more
• Support for captions and bubble tooltips
• Add any content type to tooltips/captions
• Event type options (hover/click)
• Change tooltip position relative to spot
• Create spots with your own HTML markup
• CSS transitions/Animations are supported
• Built with performance in mind
• Responsive-friendly
• Very small (just 4kb minified)

Getting Started

• Include the jQuery library and the PicTip plugin on your page. It can also be installed using Bower or npm:

bower install jquery-pictip

npm install jquery-pictip

• Call the pictip() method on the jQuery element that contains your image(s). Let me show you an example:

The HTML

<div id="pictip-demo"> </div>

The CSS

#pictip-demo{
    position: relative;
}
.spot{
  /* make it look pretty */
}
.spot-tooltip{
  /* make it look pretty */
}

Use the following clases for customization:

Class	Description
spot	Spot class
spot-{index}	Class containing the spot indetifier (spot-0, spot-1, etc)
spot-open	Class assigned to the spot when the related tooltip is open
spot-tooltip	Tooltip class
spot-tooltip-{index}	Class containing the tooltip indetifier (spot-tooltip-0, spot-tooltip-1, etc)
spot-tooltip-close	Class assigned to the tooltip close link
spot-tooltip-content	Class assigned to the tooltip content container

The JavaScript

$("#pictip-demo").pictip({
    spots: [
        {
            top: '50px',
            left: '20px',
            content: 'Hello!',
            tooltipPosition:'br' //bottom-right
        }
    ]
});

The complete set of options:

Option	Description
spots [ Array: [] ]	Spots object array. Refer to the next table for more information.
spotClass [ String: '.spot' ]	Spots class.
spotTemplate [ String: '' ]	HTML template to create the spots.
eventType [ String: 'click' ]	Event type to trigger the tooltip/caption display action (posible values are click and mouseenter).
tooltip [ Boolean: true ]	Display tooltip or caption? (use caption for a better mobile experience).
show [ Function: function (tooltip) {} ]	Function that overrides the plugin default show functionality.
close [ Function: function (tooltip) {} ]	Function that overrides the plugin default close functionality.
onShowToolTip [ Function: function (spot, tooltip) {} ]	Function executed after the tooltip has opened
onCloseToolTip [ Function: function (spot, tooltip) {} ]	Function executed after the tooltip has closed

Functions onShowToolTip and onCloseToolTip are not executed if show and close functions are defined.

Spots set of options:

Option	Description
top [ Number: 0 ]	Spot top position
left [ Number: 0 ]	Spot left position
content [ String: '' ]	Tooltip content. Add any content type
tooltipPosition [ String: '' ]	Tooltip position relative to spot. (tl, tr, tc, bl, br, bc, cl, cr)
tooltipId [ String: '' ]	Tooltip ID
tooltipCss [ Object: {} ]	CSS styling for the tooltip
tooltipClose [ Boolean: false ]	Set this to true if you want the tooltip close link
open [ Boolean: false ]	Set this to true if you want the tooltip to be open on page load

The API

Accessing the PicTip instance.

// You can access the instance with:
var pictip = $("#pictip-demo").data('pictip');

You can access the following methods of the instance:

Method	Description
init [ Function: function (options) {...} ]	Initialize the plugin instance
closeToolTips [ Function: function () {...} ]	Close all open tooltips
destroy [ Function: function () {...} ]	Destroy the plugin instance

Changelog

v0.3.0

• Adding CSS transitions/animations support (through the new show and close configuration options)
• Adding position class to tooltip elements in order to describe the tooltip position (relative to spot)

v1.0.0

• Adding performance improvements for responsive sites

v1.1.0

• Adding "open by default" option

Contributing

If you'd like to contribute to this project, create a branch and send a pull request for that branch. Hint and test your code.

Any problems, please, let me know.

License

Copyright (c) 2015 Daniel Fernández A. Dual licensed under the MIT and GPL licenses.