Skip to content

Tooltip(提示框)

使用$.fn.iTooltip.defaults重写默认值对象。

当用户将鼠标移动到元素上的时候,将会显示一个消息提示框。提示框的内容可以是页面中任何一个HTML元素或者通过Ajax发送后台请求以获取提示框内容。

用法

1. 通过标签创建提示框,给元素添加一个"topjui-tooltip"的类名,无需任何Javascript代码。

html
<a href="#" title="This is the tooltip message." data-toggle="topjui-tooltip">Hover me</a>

2. 通过Javascript创建提示框。

html
<a id="dd" href="javascript:void(0)">Click here</a>
javascript
$('#dd').iTooltip({
  position: 'right',
  content: '<span style="color:#fff">This is the tooltip message.</span>',
  onShow: function(){
    $(this).iTooltip('tip').css({
      backgroundColor: '#666',
      borderColor: '#666',
    });
  }
});

属性

属性名属性值类型描述默认值
positionstring消息框位置。可用值有:"left","right","top","bottom"bottom
contentstring,function消息框内容。见下方代码示例。null
trackMouseboolean为true时,允许提示框跟着鼠标移动。false

属性代码示例

content属性示例:

javascript
$('#tt').iTooltip({ content: 'This is the tooltip message.' });
javascript
$('#tt').iTooltip({ content: function(){ return '<div>...</div>'; } });

| deltaX | number | 水平方向提示框的位置。 | 0 |
| deltaY | number | 垂直方向提示框的位置。 | 0 |
| showEvent | string | 当激发什么事件的时候显示提示框。 | mouseenter |
| hideEvent | string | 当激发什么事件的时候隐藏提示框。 | mouseleave |
| showDelay | number | 延时多少秒显示提示框。 | 200 |
| hideDelay | number | 延时多少秒隐藏提示框。 | 100 |

事件

事件名事件参数描述
onShowe在显示提示框的时候触发。
onHidee在隐藏提示框的时候触发。
onUpdatecontent在提示框内容更新的时候触发。
onPositionleft,top在提示框位置改变的时候触发。
onDestroynone在提示框被销毁的时候触发。

方法

方法名方法参数描述
optionsnone返回控件属性对象。
tipnone返回tip元素对象。
arrownone返回箭头元素对象。
showe显示提示框。
hidee隐藏提示框。
updatecontent更新提示框内容。
repositionnone重置提示框位置。
destroynone销毁提示框。

基于最新稳定版jQuery EasyUI构建的前端框架