tipso是一款非常实用的轻量级响应式jQuery Tooltip插件。该Tooltip插件可以和Animate.css配合使用,制作各种Tooltip显示时的动画效果。还可以通过Ajax来动态加载Tooltip的内容。并且提供了大量参数来控制Tooltip的显示和行为。
使用方法
使用该Tooltip插件首先要引入jQuery和tipso.js以及tipso.css文件。
<link rel="stylesheet" href="/path/to/tipso.css"> <script src="jquery/1.11.0/jquery.min.js"></script> <script src="/path/to/tipso.js"></script>
如果你需要使用CSS3的动画效果,请引入Animate.css。
<link rel="stylesheet" href="/path/to/animate.css">
调用插件
$('.tipso').tipso();
配置参数
下面是该Tooltip插件的一些可用的参数。
参数 | 默认值 | 描述 |
speed | 400 | fade效果的持续时间,单位毫秒 |
background | '#55b555' | tooltip的背景颜色,它可以是hex、rgb、rgba或颜色关键字 |
color | '#ffffff' | tooltip的前景色,它可以是hex、rgb、rgba或颜色关键字 |
position | 'top' | tooltip的初始化位置,可用的位置有: 'top', 'bottom', 'left', 'right' |
width | 200 | tooltip的宽度,单位像素 |
delay | 200 | 显示tooltip之前的延时时间,单位毫秒 |
animationIn | '' | 使用Animate.css的CSS3动画效果显示tooltip |
animationOut | '' | 使用Animate.css的CSS3动画效果隐藏tooltip |
offsetX | 0 | tooltip在X轴上的偏移值 |
offsetY | 0 | tooltip在Y轴上的偏移值 |
content | null | tooltip的内容,可以是文本、HTML代码或其它内容 |
ajaxContentUrl | null | Ajax调用tooltip内容的URL地址 |
useTitle | true | 是否使用默认的title属性作为tooltip的内容 |
onBeforeShow | function(){} | tooltip显示前的回调函数 |
onShow | function(){} | tooltip显示之后的回调函数 |
onHide | function(){} | tooltip隐藏之后的回调函数 |
另外,你可以使用data-tipso
属性来替代title
属性作为tooltip的内容(要设置useTitle: false
)。
方法
下面是该tooltip插件的一些可用方法。
// Show the tipso tooltip $('.tipso').tipso('show'); // Hide the tipso tooltip $('.tipso').tipso('hide'); // Destroy tipso tooltip $('.tipso').tipso('destroy'); // Add a callback before tipso is shown $('.tipso').tipso({ onBeforeShow: function(){ // Your code } }); // Add a callback when tipso is shown $('.tipso').tipso({ onShow: function(){ // Your code } }); // Add a callback when tipso is hidden $('.tipso').tipso({ onHide: function(){ // Your code } }); // Load AJAX content to tipso $('.tipso').tipso({ useTitle: false, ajaxContentUrl : 'ajax.html' }); // Update tipso options $('.tipso').tipso('update', 'content', 'new content');