tooltipster-discovery
v1.0.2
Published
A Tooltipster plugin to help browsing through a series of tooltips.
Downloads
55
Maintainers
louisamelineReadme
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 themouseenterortouchstartopen 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!