HTML5 tooltips工具提示jquery插件

tooltip.js是一款HTML5 tooltips工具提示jquery插件。tooltip.js可以通过js或html5 data属性来实例化一个tooltip。

它的特点还有：

可以自定义tooltip动画。
内置暗色和亮色两种主题。
可以自定义文字和阴影的颜色等属性。
允许动态的改变tooltip的内容。
允许在没有用户交互的情况下显示tooltip。

使用方法

在页面中引入jquery和tooltip.js文件，以及样式文件tooltip.css。

<script src='js/jquery.min.js'></script>
<script src='js/tooltip.js'></script>
<link rel="stylesheet" href="css/tooltip.css" type="text/css" />

通过js来初始化tooltip

第一种使用tooltip.js插件的方法是通过js来初始化tooltip。例如：

<span id="my-element">Hover Me</span>

$(document).ready(function(){
  $('#my-element').tooltip({
      // 配置参数
  });
});                  

通过data属性来初始化tooltip

第二种方法是通过HTML data属性和class来初始化tooltip。例如：

首先定义全局的tooltip属性：

$(document).ready(function(){
  ToolTip.init({
      delay: 400,
      fadeDuration: 250,
      fontSize: '1.0em',
      theme: 'light',                   
      textColor: '#757575',
      shadowColor: '#000',
      fontFamily: "'Roboto-Medium', 'Roboto-Regular', Arial"
  });
});                  

然后通过data-tip属性和tip-hotspotclass来定义一个tooltip。

<button class="tip-hotspot" data-tip="This is the tooltip text">Button text here</button>

配置参数

使用第一种通过js来初始化tooltip的方法时，可以使用下面的配置参数：

参数	是否必须	描述
text	是	tooltip上显示的内容。
delay	否	tooltip显示的延迟时间。默认为0。
fadeDuration	否	淡出的持续时间，单位毫秒，默认为250毫秒。
fontSize	否	tooltip的字体大小，默认为1em。
theme	否	tooltip的主题。可选有'dark'和'light'。
textColor	否	文字的颜色。
shadowColor	否	阴影的颜色。
fontFamily	否	字体族。默认为'Arial, Helvetica, sans-serif'。

示例：

$(document).ready(function(){
  $('#my-element').tooltip({text: '这是一个tooltip'});
});             

带参数的tooltip：

$(document).ready(function(){
  $('#my-element').tooltip({
    text: '这是一个tooltip',
    fontSize: '14px',
    theme: 'light',
    fontFamily: "'Roboto-Medium', 'Roboto-Regular', Arial",
    delay: 400
  });
});            

方法

使用第一种通过js来初始化tooltip的方法时，可以使用下面的方法：

setText：设置文字。

$('#my-element').tooltip('setText', 'This is the new tooltip text');

autoTip：自动显示tooltip。

$('#my-element').tooltip('autoTip', {MY OPTIONS});

自动显示tooltip的可用配置参数有：

参数	是否必须	描述
displayDuration	否	tooltip多久才被显示。默认为5000毫秒。
fadeOutDuration	否	淡出的持续时间，默认为1000毫秒。
onShowCallback	否	tooltip出现时的回调函数。
onHideCallback	否	tooltip隐藏时的回调函数。

示例：使用setText来设置文字，然后使用autoTip来自动显示tooltip。

$('#social-messages-button').tooltip('setText', 'You have 1 new message');
$('#social-messages-button').tooltip('autoTip', {
    displayTime: 4000,
    fadeOutDuration: 5000,
    onShowCallback: function(){
      // play notification sound
    }
}); 