A Tooltipster plugin to help browsing through a series of tooltips
JavaScript HTML
Latest commit 3b211f2 Jun 14, 2016 @louisameline _
Permalink
Failed to load latest commit information.
demo fix flashing tooltips Jun 14, 2016
LICENSE Initial commit Dec 14, 2015
README.md Naming conventions Jun 12, 2016
bower.json indent Jun 13, 2016
package.json _ Jun 14, 2016
tooltipster-discovery.js _ Jun 14, 2016
tooltipster-discovery.min.js _ Jun 14, 2016

README.md

tooltipster-discovery

Discovery is a Tooltipster plugin to help browsing through a series of tooltips. MIT license.

The idea is that if you hover over an element which makes a tooltip appear, and then move to an adjacent element also with a tooltip, there should be no "closing" and "opening" animations. The first tooltip closes and the second one opens immediately. This is useful when you have a row of adjacent elements, and a user wants to "browse" the tooltips of each one.

The behavior offered by this plugin is exactly the one demonstrated on Tooltipster's documentation page in the Grouped tooltips section.

Installation

Include the plugin file in your page AFTER the Tooltipster file.

<html>
    <head>
        ...
        <script type="text/javascript" src="tooltipster/dist/js/tooltipster.bundle.min.js"></script>
        <script type="text/javascript" src="tooltipster-discovery/tooltipster-discovery.min.js"></script>
    </head>
</html>

Usage

Add a common class name to the tooltips you wish to group, for example 'grouped':

<html>
    <body>
        <span class="tooltip" title="vegetable">Carrot</span>

        <span class="tooltip grouped" title="Fruit">Cherries</span>
        <span class="tooltip grouped" title="Fruit">Oranges</span>
        <span class="tooltip grouped" title="Fruit">Apples</span>
    </body>
</html>

Initialize your tooltips as usual:

$('.tooltip').tooltipster({...});

This plugin only works for the tooltips which use the 'hover' trigger (specifically the mouseenter or touchstart open triggers).

Discovery will have created a group core method. Use it to create a group based on the 'grouped' class name:

$.tooltipster.group('grouped');

And that's it, it should work.

To restore the normal behavior of the tooltips, just call the ungroup method:

$.tooltipster.ungroup('grouped');

You do not have to declare the Discovery plugin in the options of the tooltips, because it works at Tooltipster's core level only, not at the instance level.

Thanks to @matthew-dean for the idea of this plugin!