Simpletooltip

Installation:

Download the plugin and decompress files, put the folder simpletooltip in your tree project files, would be nice create a folder that contains it, for example js (/js/simpletooltip).

In the header of your document attach the scripts simpletooltip.min.css and simpletooltip.min.js. Of course, you will need to load jQuery first:

Usage

To initialize the plugin you have 2 options:

Using data attribute

First declare data-simpletooltip="init" in the html element, and complete the attribute title, that will be the content of the tooltip. The plugin will initialize automatically.

<h1 data-simpletooltip="init" title="This is a tooltip">This is a header</h1>

Using JavaScript

You can use the jquery function simpletooltip() to initialize the plugin for one or more objects together. Remember the attribute title must exist in each element.

<h1 title="This is a tooltip">This is a header</h1>

<script>
    jQuery(document).ready(function($) {
        $('h1').simpletooltip();
    });
</script>

Simpletooltip was thought for use small and descriptive texts in order to substitute the ugly yellow tooltip that browsers offers by default. Anyway, you can insert more complex content like linebreaks, lists, images, etc...

<h1 data-simpletooltip="init" title="<img src='icon.png'>">image</h1>

♣ example

Options:

You can add some options to customize your tooltips. This options works in cascade, that means you can override them. Here, the priorities:

1. The default options will be applied at first instance.
2. Your global options will override the default ones.
3. Your theme options will override the global ones
4. All data attributes will override the rest.

Default options

Global options

You can add it globally, witch affects all tooltips of your queried objects:

Custom options

Or be more specific and override 1 option in 1 tooltip using data attribute:

Positions:

Simpletooltip has 12 funcional positions, by default goes on top position, but you can choose: top  top-left  left-top  left  left-bottom  bottom-left  bottom  bottom-right  right-bottom  right  right-top  top-right.

To add the desired position, in that example we'will use attribute data-simpletooltip-position.

♣ example:

Themes

Themes are packages of options you can set up in one place, Simpletooltip comes with 4 default themes, you can choose: blue  white  dark  gray.

To assign a theme, configure theme parameter with the theme name:

♣ example:

Also you can extend it, imagine a blue theme without border:

♣ example:

Creating Themes

Also you can create your own themes. Imagine you need to repeat continuously 2 schemes in your site and don't want to fill your html code with noisy variables inside data attributes. For that you can use themes attribute.

<script>
    jQuery(document).ready(function($) {
        $('.tooltip').simpletooltip({
            themes: {
                pink: {
                    color: 'red',
                    border_color: 'red',
                    background_color: 'pink',
                    border_width: 4
                },
                brazil: {
                    color: 'yellow',
                    background_color: 'green',
                    border_color: 'yellow',
                    border_width: 4
                }
            }
        });
    });
</script>

♣ example:

Actual Version: 1.3.0

Latest Update: 11.06.2014

Also, you can access to the Github repo.

Do you have any great idea?
Contribute on Github issues

Simpletooltip helped you?